Repolode
Dicklesworthstone

Dicklesworthstone/ultimate_mcp_client

基于 Python 异步实现的 MCP 客户端,提供交互式 CLI 与 Web 界面,连接 AI 模型与 stdio、SSE、streaming-http 类型的 MCP 服务器。

Star
171
Fork
23
未关闭 Issue
0
最近提交
8天前

这是什么?

Ultimate MCP Client 是一个 Python 实现的 Model Context Protocol(MCP)客户端,用于让 AI 模型统一访问外部工具、资源和提示词模板。它通过 Anthropic SDK 连接 Claude 模型,可接入以本地 stdio 进程运行的 MCP 服务器,也支持 SSE 和 streaming-http 远程端点,并把工具调用转发给提供该工具的服务器。

项目提供两种界面,共享同一套核心逻辑:基于 FastAPI、WebSocket、Alpine.js 和 DaisyUI 的 Web 界面,以及基于 Typer 和 Rich 的命令行,后者包含斜杠命令、实时 TUI 仪表盘和批量查询。会话以可分支的图结构保存,支持分叉、切换分支、摘要压缩上下文,并可导入导出为 JSON。

服务器发现方面,支持扫描本地脚本目录、导入 Claude Desktop 配置(并适配 WSL 路径)、连接远程注册中心、通过 mDNS 发现局域网服务,以及可选的端口扫描。工具结果可按类别设置 TTL 做磁盘缓存,并支持依赖关系失效;内置 OpenTelemetry 指标与链路追踪。

核心功能

  • 01支持通过 stdio、SSE 和 streaming-HTTP 连接 MCP 服务器。
  • 02Web 界面支持实时流式对话、服务器管理和会话分支可视化。
  • 03交互式 CLI 提供斜杠命令、Markdown 渲染和实时 TUI 仪表盘。
  • 04会话以分支图管理,支持分叉、切换、摘要压缩及 JSON 导入导出。
  • 05可通过本地目录、Claude Desktop 配置、远程注册中心、mDNS 和端口扫描发现服务器。
  • 06工具结果支持按 TTL 缓存,并可按依赖关系失效。

适用场景

  • 无需自行开发客户端,即可在 Claude 中试用 MCP 工具。
  • 调试本地 MCP 服务器,查看原始 JSON-RPC 消息和 stderr 日志。
  • 搭建自托管聊天界面,把 Claude 连接到本地和远程工具服务器。
  • 通过分叉会话比较不同的对话路径。

快速上手

  1. 1

    安装 uv(运行 README 中的官方安装脚本)

  2. 2

    克隆仓库

    git clone https://github.com/Dicklesworthstone/ultimate_mcp_client
  3. 3

    安装依赖(需要 Python 3.13+)

    uv sync --all-extras
  4. 4

    启动 Web UI(请先设置 ANTHROPIC_API_KEY)

    mcpclient run --webui

使用前须知

  • 需要 Python 3.13 或更高版本。
  • 使用 Claude 模型需要 Anthropic API 密钥。
  • 许可证为非标准条款(带 OpenAI/Anthropic 附加条款的 MIT),商业使用前请先核对条款。

标签

常见问题

ultimate_mcp_client 是什么?
基于 Python 异步实现的 MCP 客户端,提供交互式 CLI 与 Web 界面,连接 AI 模型与 stdio、SSE、streaming-http 类型的 MCP 服务器。 Ultimate MCP Client 是一个 Python 实现的 Model Context Protocol(MCP)客户端,用于让 AI 模型统一访问外部工具、资源和提示词模板。它通过 Anthropic SDK 连接 Claude 模型,可接入以本地 stdio 进程运行的 MCP 服务器,也支持 SSE 和 streaming-http 远程端点,并把工具调用转发给提供该工具的服务器。
ultimate_mcp_client 可以免费使用吗?用的什么许可证?
ultimate_mcp_client 以 Other 许可证开源。用于商业产品前,请先确认许可证条款。
ultimate_mcp_client 还在维护吗?
活跃维护中。ultimate_mcp_client 最近一次提交是在 2026年10月14日。
ultimate_mcp_client 适合用来做什么?
无需自行开发客户端,即可在 Claude 中试用 MCP 工具。 调试本地 MCP 服务器,查看原始 JSON-RPC 消息和 stderr 日志。 搭建自托管聊天界面,把 Claude 连接到本地和远程工具服务器。 通过分叉会话比较不同的对话路径。
ultimate_mcp_client 怎么安装和运行?
安装 uv(运行 README 中的官方安装脚本) 克隆仓库: git clone https://github.com/Dicklesworthstone/ultimate_mcp_client 安装依赖(需要 Python 3.13+): uv sync --all-extras 启动 Web UI(请先设置 ANTHROPIC_API_KEY): mcpclient run --webui
在哪里获取 ultimate_mcp_client?
源代码和安装说明在 GitHub 上:https://github.com/Dicklesworthstone/ultimate_mcp_client

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目