跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / BashNode.jsAI

命令行工具 MCPHost:利用模型上下文协议连接大模型与外部工具

综述由AI生成MCPHost 是一款轻量级命令行工具,允许大型语言模型通过模型上下文协议(MCP)调用外部工具。本文记录了从下载安装、配置 MCP 服务到实际交互的全过程。重点测试了不同模型对函数调用的支持情况,发现 DeepSeek V3 在本地部署环境下能成功调用 Time MCP 服务获取准确时间,而部分模型存在兼容性问题。同时分享了关于依赖环境及安全软件配置的注意事项,为开发者搭建 AI 工具链提供参考。

鲜活发布于 2026/3/16更新于 2026/6/821 浏览
命令行工具 MCPHost:利用模型上下文协议连接大模型与外部工具

MCPHost 简介

MCPHost 是一款轻量级命令行工具,允许大型语言模型(LLM)通过模型上下文协议(MCP)与外部工具进行交互。它支持 Claude、Ollama 等多种模型接入,本次实战基于本地部署的 DeepSeek V3 模型,成功跑通了 Time MCP 服务。

项目托管于 GitHub:mark3labs/mcphost

环境准备与安装

MCPHost 使用非常便捷,无需复杂编译,直接下载解压即可运行。官方提供了 Windows、Linux 和 macOS 三个系统的压缩包。

下载地址:[Releases - v0.4.4](https://Windows 系统下,直接下载压缩包并解压到工作目录,即可得到可执行文件。若希望全局调用,可将该目录加入系统 PATH 环境变量。

前置依赖方面,建议先安装好 uv 和 nodejs,以便后续运行部分 MCP 服务器。

配置与服务启动

创建配置文件

在工作目录下创建一个名为 mcp.json 的配置文件,用于定义可用的 MCP 服务。例如配置一个时间服务:

{
  "mcpServers": {
    "time": {
      "command": "uvx",
      "args": ["mcp-server-time", "--local-timezone=Asia/Shanghai"]
    }
  }
}

连接 AI 服务器

你需要一个 AI API 服务地址,可以是自建服务(如 Ollama、LMStudio),也可以是 OpenAI、硅基流动等提供的 API。假设本地搭建的服务地址为 http://192.168.1.5:1337。

使用以下命令连通 AI 服务器,加载配置文件中的服务并进入交互界面:

mcphost --openai-api-key=$OPENAI_API_KEY -m openai:gpt-4o --openai-url http://192.168.1.5:1337 --config mcp.json

进入交互界面后,即可输入自然语言指令。例如询问当前时间。

常用指令

在交互界面中,可以使用内置指令查看帮助或管理工具:

  • /help: 显示帮助信息
  • /tools: 列出所有可用工具
  • /servers: 列出已配置的 MCP 服务
  • /history: 显示对话历史
  • /quit: 退出应用
  • 此外,命令行参数也支持指定模型,例如:

    mcphost -m ollama:qwen2.5:3b
    

    交互实践与调试

    在实际测试过程中,不同模型对 MCP 函数调用的支持程度差异明显。

    模型兼容性排查

    初期尝试使用 GPT-4o 模型,虽然能正常回复,但无法正确调用时间工具获取实时数据。随后切换到 Claude 3.5 Sonnet,发现存在连接异常(ContentLengthError: 400),可能是自建服务对该模型的适配问题。

    经过多次尝试,最终确认 DeepSeek V3 模型在本地环境下支持良好,能够准确触发函数调用并返回结果。

    安全软件配置

    在 Windows 环境下,如果 uv cache 所在的临时目录被安全软件拦截,可能导致进程无法启动。建议将相关目录添加到信任列表,以避免潜在的网络通信故障。

    完整交互示例

    使用 DeepSeek V3 模型成功调用时间服务后的交互记录如下:

    Assistant: Hi there! How can I assist you today?
    User: what time is it?
    Assistant: Current Time - Today is Monday, March 17, 2025.
               The exact time depends on your location...
    

    更详细的中文交互表现:

    User: 请告诉我现在的时间,谢谢
    Assistant: 您好!今天是 2025 年 3 月 19 日,星期三。以下是当前的时间信息:
               • 日期:2025 年 3 月 19 日
               • 星期:星期三
               • 时区:CST(中国标准时间,UTC/GMT +8 小时)
               • 时间:上午 9:28:45
    

    需要注意的是,并非所有模型都能稳定响应 MCP 请求。DeepSeek V3 和 Llama 3.2/3.3 系列在测试中表现较好,而部分模型可能需要更精细的提示词工程或配置调整。

    小结

    MCPHost 小巧实用,有效架起了大模型与 MCP 之间的桥梁。目前测试下来,DeepSeek V3、Llama 3.2:3b、Llama 3.3:70b 等模型对 MCP 的支持较为理想。对于开发者而言,选择合适的模型并进行适当的本地化配置,是实现自动化任务的关键。后续可继续探索更多模型与工具的兼容组合。

    目录

    1. MCPHost 简介
    2. 环境准备与安装
    3. 配置与服务启动
    4. 创建配置文件
    5. 连接 AI 服务器
    6. 常用指令
    7. 交互实践与调试
    8. 模型兼容性排查
    9. 安全软件配置
    10. 完整交互示例
    11. 小结
    • 💰 8折买阿里云服务器限时8折了解详情
    • Magick API 一键接入全球大模型注册送1000万token查看
    • 🤖 一键搭建Deepseek满血版了解详情
    • 一键打造专属AI 智能体了解详情
    极客日志微信公众号二维码

    微信扫一扫,关注极客日志

    微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

    更多推荐文章

    查看全部
    • Go Web 开发必备理论知识
    • Python 项目标准目录结构详解
    • 大模型应用落地挑战与实施策略指南
    • 昇腾 NPU 部署与推理 Llama 模型实战指南
    • 大模型提示工程实战指南:掌握提问驱动 AI
    • Python 调用 Dify API 实现知识检索与前端溯源展示
    • DJI DroneID 信号解析工具与 SDR 分析指南
    • Rust 实战:从零构建二维码艺术生成器
    • Kubernetes: 使用 kubectl 插件 ketall 查看所有 API 对象资源
    • Java 对接飞书多维表格使用详解
    • 单链表实战:删除指定节点、反转链表与查找中间节点
    • LiquidBounce:基于 Fabric API 的 Minecraft 开源注入客户端
    • Python __slots__:减少内存占用的高级技巧
    • LIBERO:面向终身机器人学习的综合基准数据集
    • 2026 届学位论文 AIGC 检测率要求汇总与应对策略
    • Python 修改 pip 默认安装路径的几种方法
    • 基于Xilinx FPGA的RISC-V五级流水线CPU设计与实现
    • ctfshow-web257 PHP 反序列化漏洞分析与 Payload 构造
    • 算法实战:替换所有问号与提莫攻击
    • 马尔可夫决策过程 (MDP) 原理与代码实战案例

    相关免费在线工具

    • RSA密钥对生成器

      生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

    • Mermaid 预览与可视化编辑

      基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

    • 随机西班牙地址生成器

      随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

    • Base64 字符串编码/解码

      将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

    • Base64 文件转换器

      将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

    • Markdown转HTML

      将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online