跳到主要内容
极客日志极客日志
首页博客AI提示词GitHub精选代理工具
搜索
|注册
博客列表
Shell / BashNode.jsAI

MCPHost:命令行下利用 MCP 协议与大模型交互的实践

综述由AI生成MCPHost 是一款命令行工具,允许大语言模型通过模型上下文协议(MCP)与外部工具交互。记录了在本地搭建 AI 服务后,配置 Time MCP 服务器并与 DeepSeek、GPT 等模型进行联调的过程。实践中发现不同模型对函数调用的支持程度存在差异,DeepSeek-V3 表现较好。文章提供了配置文件示例、常用命令及调试经验,帮助开发者快速上手 MCP 协议集成。

灰度发布发布于 2026/3/15更新于 2026/4/272 浏览
MCPHost:命令行下利用 MCP 协议与大模型交互的实践

小巧的 MCPHost

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

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

下载安装

使用非常方便,直接下载解压即可运行。官网提供 Windows、Linux 和 macOS 三个系统的压缩包。

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

前置依赖:建议先安装好 uv 和 Node.js。

MCPHost 交互实践

配置 MCP 服务

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

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

同时需要确保 AI 服务可用。可以搭建本地服务器(如 http://192.168.1.5:1337),或使用 OpenAI、Ollama、硅基流动等提供的 API 接口。

启动交互

使用一条命令即可连通 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 参数查看命令行帮助,了解支持的模型格式(如 anthropic:claude-3-5-sonnet-latest 或 ollama:modelname)及各类 API 密钥配置选项。

    调试与模型兼容性

    在联调过程中,不同模型对函数调用的支持程度存在差异。

    1. 模型选择:尝试过 GPT-4o 和 Claude-3.5-Sonnet,前者无法准确报时,后者在自建服务器上可能出现连接错误。最终测试发现 DeepSeek-V3 表现较好,能够正确调用工具返回时间。
    2. 环境权限:若遇到进程无法启动的问题,建议将 uv cache 所在的临时目录加入安全软件白名单,防止被拦截。
    3. 完整交互示例:
    Assistant: 您好!今天是 2025 年 3 月 19 日,星期三。以下是当前的时间信息:
    当前时间 • 日期:2025 年 3 月 19 日 • 星期:星期三 • 时间:上午 9:28:45 • 时区:CST
    如果您需要进一步帮助,请随时告诉我!
    

    虽然 DeepSeek-V3 能完成任务,但并非每次都能完美响应。官方推荐的 Claude-3.5-Sonnet 效果可能更稳定,有相关资源的朋友可以尝试对比。

    目前测试下来支持 MCP 的模型包括:DeepSeek-V3、Llama3.2:3b、Llama3.3:70b 等。

    总结

    MCPHost 小巧实用,是连接大模型与 MCP 协议的便捷桥梁。尽管部分模型在函数调用上仍有优化空间,但它为开发者快速验证 MCP 能力提供了很好的入口。建议在实际使用中多尝试不同模型,找到最适合当前场景的组合。

    目录

    1. 小巧的 MCPHost
    2. 下载安装
    3. MCPHost 交互实践
    4. 配置 MCP 服务
    5. 启动交互
    6. 常用指令
    7. 调试与模型兼容性
    8. 总结
    • 💰 8折买阿里云服务器限时8折了解详情
    • 💰 8折买阿里云服务器限时8折购买
    • 🦞 5分钟部署阿里云小龙虾了解详情
    • 🤖 一键搭建Deepseek满血版了解详情
    • 一键打造专属AI 智能体了解详情
    极客日志微信公众号二维码

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

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

    更多推荐文章

    查看全部
    • Flutter 三方库 webdriver 在鸿蒙系统的适配与使用指南
    • Stable Diffusion v1.5 WebUI 高可用架构:双实例 + 负载均衡 + 健康检查
    • 数据结构:单向链表的基本操作
    • C++ 多态底层实现原理与内存布局解析
    • Playwright 基础教程:元素拖拽、坐标获取与文本提取实战
    • Java Web 开发基础与 Servlet 核心技术
    • 数据结构:常见排序算法详解
    • 豆包 Seedream 4.0 多图融合实战:主体一致性与 4K 生成体验
    • Cppcheck:C/C++ 代码静态分析工具的使用指南
    • 2026 AI 医疗行业专题报告:智能医疗器械、手术机器人、脑机接口与可穿戴设备
    • OpenClaw 本地部署、隧道映射与大模型接入指南
    • Copilot 最佳使用方式与配置指南
    • 检索增强生成 (RAG) 技术原理与 LangChain、LlamaIndex 实践
    • 全国计算机等级考试(二级 Web 程序设计)安排与例题解析
    • 大模型 LLM 四阶段技术详解:从提示工程到预训练
    • Linux 信号内核结构、保存与处理全链路剖析
    • Spring Boot 3.x 启动报错 factoryBeanObjectType 解决方案
    • 选择排序算法详解:直接、树形与堆排序
    • 鸿蒙 Share Kit 碰一碰分享功能开发指南
    • OpenClaw Windows 版部署与 DeepSeek API 配置指南

    相关免费在线工具

    • 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