Repolode
hideya

hideya/mcp-client-langchain-py

基于 LangChain 和 Python 的命令行客户端,用于测试和探索 MCP 服务器。

Star
13
Fork
4
未关闭 Issue
0
最近提交
2个月前

这是什么?

mcp-chat 是一个用于 Model Context Protocol(MCP)服务器的简单命令行客户端。它可以连接本地 stdio 服务器或远程 HTTP 服务器,加载其中的工具,并通过 LangChain ReAct Agent 与所选大模型对话调用这些工具。

工具使用 JSON5 配置文件,格式与 Claude for Desktop 的 MCP 配置相同,并支持用环境变量替换 API 密钥等敏感信息。支持的模型提供商包括 OpenAI、Anthropic、Google GenAI、xAI、Cerebras 和 Groq,本地 stdio 服务器的日志可保存到指定目录。

目前仅支持 MCP Tools,工具返回结果仅限文本内容,不支持 Resources、Prompts 和 Sampling。项目基于 langchain-mcp-tools 构建,适配 MCP 协议 2025-03-26 版本。

核心功能

  • 01支持连接本地 stdio 和远程 HTTP 两类 MCP 服务器。
  • 02通过 LangChain ReAct Agent 与可配置的大模型结合调用 MCP 工具。
  • 03使用与 Claude for Desktop 兼容的 JSON5 配置格式。
  • 04配置中可用环境变量替换 API 密钥等凭据。
  • 05支持 OpenAI、Anthropic、Google GenAI、xAI、Cerebras 和 Groq 模型。
  • 06可将 stdio 服务器日志保存到指定目录,并提供详细日志模式。

适用场景

  • 在将 MCP 服务器接入应用前测试其工具是否正常工作。
  • 快速了解新 MCP 服务器提供了哪些能力。
  • 原型验证大模型与外部工具之间的集成方案。

快速上手

  1. 1

    使用 pip 安装 mcp-chat 工具

    pip install mcp-chat
  2. 2

    创建 llm_mcp_config.json5 配置文件,填写 LLM 和 MCP 服务器设置

  3. 3

    在 .env 文件中设置 LLM API 密钥

  4. 4

    运行该工具

    mcp-chat

使用前须知

  • 仅支持工具调用的文本结果,图片等其他内容类型会被过滤。
  • 仅支持 MCP Tools,不支持 Resources、Prompts 和 Sampling。
  • 不支持 MCP 2026-07-28 规范,目前面向协议版本 2025-03-26。
  • 需要至少一个受支持 LLM 提供商的 API 密钥。

标签

常见问题

mcp-client-langchain-py 是什么?
基于 LangChain 和 Python 的命令行客户端,用于测试和探索 MCP 服务器。 mcp-chat 是一个用于 Model Context Protocol(MCP)服务器的简单命令行客户端。它可以连接本地 stdio 服务器或远程 HTTP 服务器,加载其中的工具,并通过 LangChain ReAct Agent 与所选大模型对话调用这些工具。
mcp-client-langchain-py 可以免费使用吗?用的什么许可证?
mcp-client-langchain-py 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
mcp-client-langchain-py 还在维护吗?
半年内有更新。mcp-client-langchain-py 最近一次提交是在 2026年8月23日。
mcp-client-langchain-py 适合用来做什么?
在将 MCP 服务器接入应用前测试其工具是否正常工作。 快速了解新 MCP 服务器提供了哪些能力。 原型验证大模型与外部工具之间的集成方案。
mcp-client-langchain-py 怎么安装和运行?
使用 pip 安装 mcp-chat 工具: pip install mcp-chat 创建 llm_mcp_config.json5 配置文件,填写 LLM 和 MCP 服务器设置 在 .env 文件中设置 LLM API 密钥 运行该工具: mcp-chat
在哪里获取 mcp-client-langchain-py?
源代码和安装说明在 GitHub 上:https://github.com/hideya/mcp-client-langchain-py

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

相关项目