关于 mcp-client
mcp-client 是一个由 LangGraph Agent 和 CopilotKit 前端组成的应用框架,适合开发带交互界面的 Agent 应用。Agent 连接 MCP 服务并调用其工具,前端负责界面与状态同步。
主要功能
- 01LangGraph Agent 连接 MCP 服务
- 02调用 MCP 服务中的工具
- 03CopilotKit 前端界面
- 04前端与 Agent 分开运行
适用场景
- 01开发带网页界面的 Agent
- 02调试前端和 Agent 服务
- 03让 Agent 调用 MCP 工具
MCP 相关
Agent 连接 MCP 服务并调用其工具。
详细介绍
https://github.com/user-attachments/assets/364b6705-14d4-4e6d-bea7-fb9f12664fab
快速开始
设置环境变量:
touch .env
在根目录的 .env 中添加以下内容:
LANGSMITH_API_KEY=lsv2_...
OPENAI_API_KEY=sk-...
接下来,在 agent 文件夹中创建另一个 .env 文件:
cd agent
touch .env
在 agent/.env 中添加以下内容:
OPENAI_API_KEY=sk-...
LANGSMITH_API_KEY=lsv2_...
设置 Poetry:
Poetry 用于编码 Agent 服务中的依赖项管理。要安装 Poetry,请运行:
pip install poetry
要验证安装,请运行:
poetry --version
开发
我们建议在不同的终端中分别运行前端和 Agent,以便调试错误和日志:
# Terminal 1 - Frontend
pnpm run dev-frontend
# Terminal 2 - Agent
pnpm run dev-agent
或者,你可以使用以下命令同时运行两项服务:
pnpm run dev
然后,在浏览器中打开 http://localhost:3000。
架构
代码库分为两个主要部分:
/agent文件夹 – 一个连接到 MCP 服务并调用其工具的 LangGraph Agent。/app文件夹 – 一个使用 CopilotKit 进行 UI 和状态同步的前端应用。
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。