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

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

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

CodeArtist发布于 2026/2/17更新于 2026/10/2685 浏览
命令行工具 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. 总结

更多推荐文章

查看全部
  • 基于 OpenClaw 架构构建 C++ 量化交易引擎 QuantClaw 实战
  • Android 智能座舱技术趋势与 Framework 核心解析
  • AI Agent 生产级框架实战与核心架构解析
  • 移动应用登录接口越权漏洞挖掘实战
  • Java 时间类详解:JDK7 前 Date、SimpleDateFormat、Calendar 用法总结
  • Agent AI 多模态交互前沿领域综述:通往 AGI 的路径
  • GitHub Copilot Pro 学生免费权益获取与 VS Code 配置指南
  • Qwen2 大模型指令微调入门实战(附完整代码)
  • C++ 进阶:unordered_set 与 unordered_map 模拟实现
  • MCP Document Reader:让 AI 助手直接读取本地文档
  • ComfyUI Photoshop 插件配置与 AI 绘画工作流实战
  • 常见机器学习模型评估指标与方法汇总
  • 评分卡模型构建全流程:金融风控领域核心算法详解
  • 大模型 RLHF 强化学习微调过程详解与代码分析
  • 鸿蒙卡片开发实战:音乐播放器卡片构建指南
  • 把 GitHub Copilot 在 VS Code 里用顺手:中文环境下的调校与实战配置
  • Terraform 基础设施即代码入门与实践
  • 网络安全 CTF 竞赛入门指南:学习路线与实战建议
  • GitHub Copilot 与 Claude Code 功能对比分析
  • AI 提示词写作指南:精准表达与场景应用

相关免费在线工具

  • 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