用途
zin-mcp-client 是一个轻量、快速、简单的跨平台 MCP 客户端，用于在 STDIO 类型的 MCP 服务器与本地运行的 Ollama 大语言模型之间建立桥梁，填补本地 LLM 与 MCP 服务器之间的连接空白。它最初为作者开发的反向工程类 MCP 服务器（Zin MCP 套件，如 APKTool-MCP-Server、JADX-MCP-Server）而打造，同时也支持其他 MCP 服务器。
主要能力
- 多服务器支持：可同时连接多个 MCP 服务器。
- 本地 LLM 集成：通过 Ollama 使用本地模型，便于隐私与控制。
- 交互式 CLI：界面清晰直观，带丰富格式化输出。
- 轻量 Web UI：简洁、极简的网页界面。
- Open Web UI 集成：可与 Open Web UI 即插即用，借助 MCP 客户端获得其丰富功能。
- 完善日志：提供详细日志用于调试与排障。
- ReAct 智能体框架：使用 LangChain 的 ReAct 智能体模式智能调用工具。
- 跨平台支持。
- 简单、快速、轻量。
使用方式
- 从 Releases 页面下载：https://github.com/zinja-coder/zin-mcp-client/releases
- 完成 Ollama 设置。
- 配置文件设置：配置文件用于告知 zin mcp client 如何启动 MCP 服务器，风格与 Claude 的配置文件相同。默认位置为 zin-mcp-client 目录下的 mcp-config.json，也可通过 --config 选项指定自定义路径。示例配置中需将 path/to/uv 替换为 uv 可执行文件的实际路径，将 path/to/jadx-mcp-server 替换为 jadx-mcp-server 的绝对路径。
- 运行 zin_mcp_client.py：可使用 --server 指定服务器，--config 指定配置文件路径，--model 指定模型，--debug 启用详细输出。
- 运行 Web 客户端。
- 与 Open Web UI 配合：运行监听 8000 端口的 MCP Proxy，进入 Open Web UI 的 Settings -> Connection 添加连接，填入本地 MCP Proxy 的 URL（API key 可任意填写），随后即可使用。
适用场景
- 在本地通过 Ollama 模型调用 MCP 服务器工具。
- 测试自定义 MCP 服务器。
- 本地执行代码审查以发现漏洞。
- 反向工程相关的 MCP 服务器使用（Zin MCP 套件）。
- 通过 Open Web UI 获得更丰富的交互体验。
限制与注意事项
- 仓库已转为只读，作者因其他项目、资源有限、已有更好替代方案以及初始目标已达成等原因，停止了后续开发，不会继续添加功能。
- 对低配系统，建议一次只使用一个服务器，以避免 LLM 产生幻觉。
- 当前专有 API 模型（如 Anthropic 的 Claude）在工具调用方面通常更强；开源模型正在快速发展，可在 Hugging Face 等平台查找标记为 function calling 或 tool use 的模型，或参考 r/LocalLLaMA 社区讨论。
- 项目已在 Mac OS 和 Linux 上使用 jadx-mcp-server、Ghidra MCP Server 测试。
- 路线图包括：集成 Open Web UI、支持基于 HTTP 的 MCP 服务器、将客户端暴露到网络（已通过 Open Web UI 集成间接完成）、本地存储聊天并提供历史记录（已通过 Open Web UI 集成间接完成）。
- 法律提示：该工具及 Zin MCP 套件严格用于教育、研究和合乎道德的安全评估目的，按“原样”提供，不附带任何明示或暗示担保。使用者需自行确保使用符合所有适用法律、法规和道德准则，仅可在获得授权的环境中使用。禁止用于未经授权的反向工程、侵犯知识产权或恶意活动。开发者不对使用或误用造成的任何损害、数据丢失、法律后果等负责。
- 许可证：ZIN MCP Client 及相关项目均继承 Apache 2.0 许可证。
链接
- 项目地址：https://github.com/zinja-coder/zin-mcp-client
- 问题反馈：https://github.com/zinja-coder/zin-mcp-client/issues
