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

命令行下的 MCPHost:让大模型通过协议调用外部工具

MCPHost 是一款允许大语言模型通过模型上下文协议(MCP)与外部工具交互的命令行工具。记录了在本地环境配置 Time MCP 服务及测试不同模型兼容性的过程。实践表明,DeepSeek-V3 能成功调用时间工具,而 GPT-4o 和 Claude 存在功能限制或连接问题。该工具为终端场景下扩展 AI 能力提供了轻量级方案,但模型选择仍需根据实际表现调整。

Qiny01发布于 2026/3/15更新于 2026/7/2035 浏览
命令行下的 MCPHost:让大模型通过协议调用外部工具

MCPHost 简介

MCPHost 是一款轻量级的命令行工具,旨在让大型语言模型(LLM)能够通过模型上下文协议(MCP)与外部工具进行交互。目前它支持 Claude 3.5 Sonnet、Ollama 以及本地部署的 DeepSeek v3 等模型。

项目地址:https://github.com/mark3labs/mcphost

安装与环境准备

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

以 Windows 为例,下载对应版本的压缩包并解压到工作目录,即可直接使用可执行文件。如果希望在任何位置调用该指令,可以将工作目录添加到系统 PATH 环境变量中。

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

配置与交互实践

创建配置文件

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

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

启动连接

接下来需要指定 AI 模型的 API 地址。你可以使用自建的服务器(如 http://192.168.1.5:1337),也可以使用 OpenAI、Ollama、LMStudio 等提供的 API 服务。

使用以下命令启动 MCPHost,它会连通 AI 服务器,加载配置的 MCP 服务并进入交互界面:

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

进入交互界面后,直接输入问题即可。例如询问时间,或者使用 /help 查看可用命令。

常用指令

在交互界面内,可以使用以下快捷指令:

  • : 显示帮助信息
/help
  • /tools: 列出所有可用工具
  • /servers: 列出已配置的 MCP 服务
  • /history: 查看对话历史
  • /quit: 退出程序
  • 此外,也可以通过命令行参数 -h 查看 MCPHost 本身的帮助文档,了解支持的模型格式(如 anthropic:claude-3-5-sonnet-latest 或 ollama:modelname)。

    模型兼容性测试

    在实际使用中,不同模型对 MCP 协议的支持程度差异较大,这里分享一些实测经验。

    遇到的问题

    起初尝试使用 GPT-4o 模型,虽然能正常回复,但无法正确调用时间工具。随后切换到 Claude 3.5 Sonnet,由于自建服务器配置问题导致连接报错(ContentLengthError: 400)。

    另外,如果在 Windows 环境下运行涉及网络通信的工具,有时会遇到进程启动失败的情况。可以尝试将 uv cache 所在的临时目录加入安全软件的信任列表,防止被拦截。

    成功方案

    最终测试发现,DeepSeek-V3 模型对函数调用的支持较好,能够顺利配合 MCP 获取实时时间。

    启动命令如下:

    mcphost --openai-api-key=$OPENAI_API_KEY -m openai:deepseek-v3 --openai-url http://192.168.1.5:1337 --config mcp.json
    

    交互示例:

    You: 请告诉我现在的时间,谢谢
    Assistant: 您好!今天是 2025 年 3 月 19 日,星期三。以下是当前的时间信息:
    当前时间 • 日期:2025 年 3 月 19 日 • 星期:星期三 • 时间:上午 9:28:45 • 时区:CST
    

    这表明 DeepSeek-V3 具备较好的工具调用能力。目前测试下来,支持 MCP 的模型还包括 deepseek-chat、llama3.2:3b 和 llama3.3:70b。

    总结

    MCPHost 小巧实用,为 CLI 场景下扩展大模型能力提供了便捷的桥梁。不过目前部分模型在工具调用上仍不够稳定,效果有待提升。如果你有其他模型的使用心得,欢迎交流对比。

    目录

    1. MCPHost 简介
    2. 安装与环境准备
    3. 配置与交互实践
    4. 创建配置文件
    5. 启动连接
    6. 常用指令
    7. 模型兼容性测试
    8. 遇到的问题
    9. 成功方案
    10. 总结
    • 免费图片AI生成工具免费生成了解详情
    • Magick API 一键接入全球大模型注册送1000万token查看
    • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
    • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
    • 100+免费在线小游戏爽一把
    极客日志微信公众号二维码

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

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

    更多推荐文章

    查看全部
    • 基于 Coze 平台的企业级 AI 客服机器人搭建实战
    • LLaMA Factory全攻略:从环境搭建到模型部署的一站式解决方案
    • FPGA 开发从入门到精通
    • C++ 入门实战指南:从环境搭建到核心概念解析
    • 快速排序核心原理与多种实现优化详解
    • Java 并发编程:JUC 包中原子操作类的原理和用法
    • C# 使用 Log4Net 配置日志
    • Spring Boot Web 后端开发核心注解详解
    • 前端流式输出实现详解:从原理到实践
    • 2025 AI 问道之旅:个人成长与深度学习理解
    • 二分查找实战:旋转排序数组最小值与缺失数字
    • OpenClaw 跨平台 AI 助手完全使用指南:从安装到高级配置
    • RAG(检索增强生成)技术详解:原理、架构与实践指南
    • 大模型面试核心问题解析:Transformer 与训练优化
    • OpenClaw 安装配置指南:Minimax/DeepSeek 模型及飞书机器人对接
    • 线性表、顺序表与链表详解(C 语言实现)
    • DFS 算法实战:水流问题、扫雷与衣橱整理
    • 基于强化学习的无人机端到端飞行控制算法开发
    • 多模态模型入门进阶:MiniGPT-4、Qwen-VL、InternVL 与 DeepSeek-VL 详解
    • 深度解析 KBQA 常用数据集:WebQSP 与 CWQ

    相关免费在线工具

    • 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