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

命令行工具 MCPHost:让大模型通过协议与外部交互

综述由AI生成MCPHost 是一款命令行工具,支持大模型通过模型上下文协议(MCP)调用外部工具。演示了如何配置 Time MCP 服务,并测试了不同模型(如 DeepSeek、GPT、Claude)的兼容性。实测 DeepSeek-v3 成功实现时间查询功能,为本地化 AI 工具链集成提供了可行方案。

CodeArtist发布于 2026/2/17更新于 2026/6/1119 浏览
命令行工具 MCPHost:让大模型通过协议与外部交互

小巧的 MCPHost

MCPHost 是一款轻量级命令行工具,允许大型语言模型(LLM)通过模型上下文协议(MCP)与外部工具进行交互。目前支持 Claude 3.5 Sonnet、Ollama 以及 DeepSeek 等模型。本文以 Time MCP 服务为例,演示如何配置并跑通本地 AI 服务。

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

下载安装

MCPHost 无需复杂安装,下载解压即可使用。官网提供 Windows、Linux 和 macOS 的压缩包。

下载地址:https://github.com/mark3labs/mcphost/releases/tag/v0.4.4

以 Windows 为例,下载压缩包后解压至工作目录,直接运行可执行文件即可。若希望全局调用,可将目录加入系统 PATH 环境变量。

前置依赖:建议先安装好 uv 和 nodejs。

MCPHost 交互实践

1. 准备配置文件

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

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

2. 启动连接

你需要一个 AI API 服务地址,可以是自建服务器(如 Ollama),也可以是 OpenAI、硅基流动等提供的 API。

使用以下命令启动 MCPHost,加载配置文件并连接 AI 模型:

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

启动后进入交互界面,输入提示词即可开始对话。

3. 内置指令

在交互界面中,可以使用 /help 查看可用指令:

  • /help: 显示帮助信息
  • : 列出所有可用工具
/tools
  • /servers: 列出已配置的 MCP 服务
  • /history: 显示对话历史
  • /quit: 退出应用
  • 例如,输入 /tools 可查看当前加载的工具列表:

    • time
      • get_current_time
        Get current time in a specific timezones
      • convert_time
        Convert time between timezones
    

    输入 /servers 可查看服务详情:

    # time
    Command uvx
    Arguments mcp-server-time --local-timezone=Asia/Shanghai
    

    4. 模型兼容性调试

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

    常见问题排查
    • GPT-4o: 可以正常回复,但有时无法准确调用时间工具。
    • Claude 3.5 Sonnet: 部分自建环境可能报错(ContentLengthError: 400),需确保模型服务配置正确。
    • Windows 安全软件: 如果 uvx 进程无法启动,尝试将缓存目录添加到杀毒软件信任列表,防止被拦截。
    实测结果

    经过多轮测试,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(中国标准时间,UTC/GMT +8 小时)
    如果您需要进一步帮助,请随时告诉我!
    

    这表明 DeepSeek-v3 已具备较好的函数调用能力,能配合 MCP 获取实时数据。

    5. 支持的模型列表

    根据测试经验,以下模型对 MCP 支持较好:

    • deepseek-v3
    • deepseek-chat
    • llama3.2:3b
    • llama3.3:70b

    当然,官方推荐的 Claude 3.5 Sonnet 效果通常更稳定,如有条件建议优先尝试。

    总结

    MCPHost 小巧实用,是连接大模型与外部工具的便捷桥梁。虽然部分模型在函数调用上仍有优化空间,但随着模型迭代,体验正在逐步提升。对于希望构建本地化 AI 工作流的开发者来说,这是一个值得关注的工具。

    目录

    1. 小巧的 MCPHost
    2. 下载安装
    3. MCPHost 交互实践
    4. 1. 准备配置文件
    5. 2. 启动连接
    6. 3. 内置指令
    7. time
    8. 4. 模型兼容性调试
    9. 常见问题排查
    10. 实测结果
    11. 5. 支持的模型列表
    12. 总结
    • 💰 8折买阿里云服务器限时8折了解详情
    • Magick API 一键接入全球大模型注册送1000万token查看
    • 🤖 一键搭建Deepseek满血版了解详情
    • 一键打造专属AI 智能体了解详情
    极客日志微信公众号二维码

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

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

    更多推荐文章

    查看全部
    • Web 前端基础:HTML 核心语法与常用标签
    • Python Pandas 高效读取 Excel 文件完整指南
    • SnapAny 视频解析下载工具:支持多平台与多种格式
    • Spring Boot 自定义注解实战:5 个高频案例详解
    • 网络安全入门指南:从零开始构建渗透测试知识体系
    • WebSite-Downloader 网站整站下载工具使用指南
    • C++ 红黑树原理与实现详解
    • OpenCV 并行处理与构建配置指南
    • 大模型训练:LLaMA-Factory 快速上手
    • Z-Image 深度评测:无需登录注册的免费 AI 图像生成工具
    • 中国大模型行业落地现状、挑战与未来趋势分析
    • PaddleOCR-VL 服务性能调优:推理速度提升 50% 的方法
    • 特殊儿童干预:基于 VoxCPM-1.5-TTS 的辅助沟通系统实践
    • Claude Skills 技术详解与实战指南
    • 使用 git-filter-repo 优雅清理 Git 历史记录
    • VS Code 中彻底禁用 GitHub Copilot 的两种方法
    • TongWeb 通道参数详解:maxQueueSize 与 acceptCount 的区别与协作
    • Python 模块与包导入机制详解
    • NVIDIA DGX Spark Ubuntu24.04 安装 Isaac Sim、Isaac Lab 与 ROS2
    • Java 12 Stream API:Collectors.teeing() 组合两个收集器结果

    相关免费在线工具

    • 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