跳到主要内容
极客日志极客日志
首页博客AI提示词GitHub精选代理工具
搜索
|注册
博客列表
编程语言AI

命令行大模型交互工具 MCPHost 使用指南

MCPHost 是一款命令行工具,支持通过模型上下文协议(MCP)让大语言模型与外部工具交互。文章涵盖安装配置、命令使用及多模型兼容性测试。实测显示 DeepSeek-v3 在函数调用场景下表现稳定,能准确获取系统时间等信息。

日志猎手发布于 2026/3/16更新于 2026/5/37 浏览
命令行大模型交互工具 MCPHost 使用指南

小巧的 MCPHost

MCPHost 可以在命令行下使用,使大型语言模型(LLM)能够通过模型上下文协议(MCP)与外部工具进行交互。目前支持 Claude 3.5 Sonnet 和 Ollama 等。本次实践使用自己架设的 DeepSeek v3 模型,跑通了 Time MCP 服务。

官方仓库:GitHub - mark3labs/mcphost

下载安装

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

https://github.com/mark3labs/mcphost/releases/tag/v0.4.4

比如 Windows 系统,直接下载压缩包,解压到工作目录,直接就是可执行文件,在工作目录即可使用。当然也可以把工作目录放入系统 PATH 路径中,就可以在任意地方调用指令了。

其它前置需求:大约需要先安装好 uv 和 nodejs。

MCPHost 交互实践

学习 MCPHost 命令

直接在命令行下,一句话就能进行 MCP 的交互,比如在工作目录创建一个 Time MCP 配置文件 mcp.json,内容如下:

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

搭建一个 AI 服务器,地址是 http://192.168.1.5:1337。或者也可以用手头有的 AI API 服务,比如 OpenAI、Ollama、硅基流动、LMStudio 等提供的 API 调用服务。

MCPHost 使用一句命令就能连通 AI 服务器,启动 mcp.json 设置的 mcp-server-time,并进入交互界面:

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

在交互界面就可以输入文字进行交互了,比如问它几点了。

┃ Enter your prompt (Type /help for commands, Ctrl+C to quit) ┃

查看帮助

可以用/help 看看 MCPHost 的指令帮助:

mcphost.exe -h MCPHost is a CLI tool that allows you to interact with various AI models through a unified . It supports various tools through MCP servers  provides streaming responses. Available models can be specified  the --model flag: - Anthropic Claude (): anthropic:claude---sonnet-latest - OpenAI: openai:gpt- - Ollama models: ollama:modelname Example: mcphost -m ollama:qwen2.:b mcphost -m openai:gpt- Usage: mcphost [flags] Flags: --anthropic-api-  Anthropic API  --anthropic-url  base URL  Anthropic API (defaults  api.anthropic.com) --config  config file (  $HOME/mcp.json) --debug enable debug logging -h, --help help  mcphost --message-window int number  messages  keep  context ( ) -m, --model  model  use (format: provider:model, e.g. anthropic:claude---sonnet-latest  ollama:qwen2.:b) ( ) --openai-api-  OpenAI API  --openai-url  base URL  OpenAI API (defaults  api.openai.com)
interface
and
using
default
3
5
4
5
3
4
key
string
key
string
for
to
string
default
is
for
of
to
in
default
10
string
to
3
5
or
5
3
default
"anthropic:claude-3-5-sonnet-latest"
key
string
key
string
for
to

进入交互界面后,还可以用/help 来看交互界面下的命令:

 • /help: Show this help message • /tools: List all available tools • /servers: List configured MCP servers • /history: Display conversation history • /quit: Exit the application You can also press Ctrl+C at any time to quit. ## Available Models Specify models using the --model or -m flag: • Anthropic Claude: anthropic:claude-3-5-sonnet-latest • Ollama Models: ollama:modelname Examples: mcphost -m anthropic:claude-3-5-sonnet-latest mcphost -m ollama:qwen2.5:3b ┃ Enter your prompt (Type /help for commands, Ctrl+C to quit) ┃

比如用/tool 看看工具:

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

可以看到当前的工具是 time。

用/services 看看服务

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

调试 mcp-server-time

用模型 claude-3-5-sonnet(模型没调通)

用 gpt-4o 模型问不出时间来。

尝试换个模型,换成 claude-3-5-sonnet

mcphost --openai-api-key=$OPENAI_API_KEY -m openai:claude-3-5-sonnet --openai-url http://192.168.1.5:1337 --config mcp.json 

这个问了问题会退出...

因为是自己搭建的服务器,所以可能是这个模型不行(不通)。后来测试了一下,确实 claude-3-5-sonnet 本身没调好,普通交互就会报错(ContentLengthError: 400)

换成 gpt-4o 或者 gpt-4,都是可以有回复的,但是无法报时,没有达到预期目标。

打开信任设置

同时所做的操作是将 uv cache 所在的目录(就是启动 mcp-server-time 服务所用的临时目录)在本地安全软件里打开信任。防止潜在的网络通信故障或进程无法启动的问题。

换成 deepseek-v3,成功!

太不容易了,最后把模型换成 deepseek-v3,终于成功了!

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

问它几点了?

 Assistant: Hi there! How can you assist you today? You: what time is it? Assistant: Current Time - Today is Monday, March 17, 2025. - The exact time depends on your location, but here are some references: - Central Daylight Time (CDT): 08:54:06 PM (UTC-5) - Eastern Daylight Time (EDT): 09:54:06 PM (UTC-4) Let me know if you'd like the time for a specific location! 

看看,它回答出了今天的日期和时间,达到了使用 MCP 获取当前时间的预期目标。也就是说 deepseek-v3 模型是支持函数调用的!

再来看个完整的交互
E:\Downloads\mcphost_Windows_x86_64>mcphost --openai-api-key=$OPENAI_API_KEY -m openai:deepseek-v3 --openai-url http://192.168.1.5:1337 --config mcp.json 2025/03/19 09:26:51 INFO Model loaded provider=openai model=deepseek-v3 2025/03/19 09:26:51 INFO Initializing server... name=time 2025/03/19 09:26:55 INFO Server connected name=time 2025/03/19 09:26:55 INFO Tools loaded server=time count=2 You: 请告诉我现在的时间,谢谢 Assistant: 您好!今天是 2025 年 3 月 19 日,星期三。以下是当前的时间信息: 当前时间 • 日期:2025 年 3 月 19 日 • 星期:星期三 • 时间:请查看您设备上的时钟以获取准确时间。 如果您需要更具体的时间信息,请告诉我您的时区,我可以为您提供更精确的时间。 You: 请告诉我现在的准确时间,谢谢 Assistant: 您好!由于我无法直接访问实时数据,无法提供当前的准确时间。建议您查看您的设备(如手机、电脑或手表)上的时钟,以获取最准确的时间信息。如果您需要帮助,请告诉我您的时区,我可以为您提供相关的时间计算方法。 You: 请告诉我当前的时间,谢谢 Assistant: 由于我无法直接访问实时数据,因此无法提供当前的准确时间。建议您查看您的设备(如手机、电脑或手表)上的时钟,以获取最准确的时间信息。如果您需要帮助,请告诉我您的时区,我可以为您提供相关的时间计算方法。 You: 我在济宁,请告诉我当前的时间 Assistant: 您好!以下是济宁当前的时间信息: 济宁当前时间 • 日期:2025 年 3 月 19 日 • 星期:星期三 • 时间:上午 9:28:45 • 时区:CST(中国标准时间,UTC/GMT +8 小时) 如果您需要进一步帮助,请随时告诉我! Goodbye!

但是它并不是每回都能正确回答,有时候可能答不出来。也许还是要用官方建议的 claude-3-5-sonnet 模型效果会更好些。有 claude-3-5-sonnet 模型的朋友可以试一下。

目前测试出来支持的模型:deepseek-v3 deepseek-chat

总结

这是一次很好的实践。

MCPHost 小巧实用,可以很方便的架起大模型和 MCP 之间的桥梁。

但是效果,尚需努力,使用 deepseek-v3 模型,离可以用,还有些距离。

测试下来支持 MCP 的模型有:deepseek-v3 llama3.2:3b llama3.3:70b

目录

  1. 小巧的 MCPHost
  2. 下载安装
  3. MCPHost 交互实践
  4. 学习 MCPHost 命令
  5. 查看帮助
  6. time Command uvx Arguments mcp-server-time --local-timezone=Asia/Shanghai
  7. 调试 mcp-server-time
  8. 用模型 claude-3-5-sonnet(模型没调通)
  9. 打开信任设置
  10. 换成 deepseek-v3,成功!
  11. 再来看个完整的交互
  12. 总结
  • 💰 8折买阿里云服务器限时8折了解详情
  • GPT-5.5 超高智商模型1元抵1刀ChatGPT中转购买
  • 代充Chatgpt Plus/pro 帐号了解详情
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

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

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

更多推荐文章

查看全部
  • 环形链表检测、数组交集与随机链表复制实战
  • Formality 原语概念详解
  • AI 调参实战:贝叶斯优化与 Optuna 应用
  • 大模型学习路线:掌握核心技术能力与关键技能
  • AI 领域今日动态:GR00T N2、Claude Code 与具身智能标准落地
  • 全球顶级AI大模型最新排名出炉!Gemini 3.1 Pro与GPT-5.4智能并列第一,中国 GLM-5强势杀入前 5,DeepSeek V3.2 成性价比之王!
  • llama.cpp 多 GPU 分布式计算优化指南
  • C++ 学习路线图:从零基础到进阶实战指南
  • 环形链表、两个数组中的交集与随机链表复制算法解析
  • 5 款主流中文 AI 大语言模型功能评测与选型指南
  • Claude Code AI 命令行工具安装使用与 MCP 配置指南
  • 基于微信小程序的助农公益平台的设计与实现
  • 可解释人工智能:从经典模型到大规模语言模型全解析
  • 《大模型应用开发极简入门》:GPT-4 与 ChatGPT 应用开发指南
  • 数据结构核心:树与堆的概念及存储实现
  • OpenClaw Java:基于 Spring Boot 的 AI Agent Gateway 全栈实践
  • OpenClaw 技能扩展实战:Tavily 联网与多维表格自动化
  • AG-UI:连接 AI 智能体与用户应用的开放协议
  • 数据库迁移 TCO 拆解:MySQL 替代隐性成本与工具链实战
  • KingbaseES 数据库智能 SQL 防护机制与实战配置

相关免费在线工具

  • 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