mcpField
M
mcp-client

mcp-client

github.com/copilotkit框架与 SDK1279 周前更新

关于 mcp-client

mcp-client 是一个由 LangGraph Agent 和 CopilotKit 前端组成的应用框架,适合开发带交互界面的 Agent 应用。Agent 连接 MCP 服务并调用其工具,前端负责界面与状态同步。

主要功能

  1. 01LangGraph Agent 连接 MCP 服务
  2. 02调用 MCP 服务中的工具
  3. 03CopilotKit 前端界面
  4. 04前端与 Agent 分开运行

适用场景

  1. 01开发带网页界面的 Agent
  2. 02调试前端和 Agent 服务
  3. 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。

架构

代码库分为两个主要部分:

  1. /agent 文件夹 – 一个连接到 MCP 服务并调用其工具的 LangGraph Agent。
  2. /app 文件夹 – 一个使用 CopilotKit 进行 UI 和状态同步的前端应用。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。