LangGraph Agents + MCP

项目概述

LangChain-MCP-Adapters 是由 LangChain AI 提供的一个工具包，它使 AI Agent 能够通过模型上下文协议（Model Context Protocol, MCP）与外部工具和数据源进行交互。本项目提供了一个用户友好的界面，用于部署能够通过 MCP 工具访问各种数据源和 API 的 ReAct Agent。

功能特性

• Streamlit 界面：一个用户友好的 Web 界面，用于与集成了 MCP 工具的 LangGraph ReAct Agent 进行交互。
• 工具管理：通过 UI 动态添加、删除和配置 MCP 工具（支持 Smithery JSON 格式），无需重启应用程序。
• 流式响应：实时查看 Agent 的回复和工具调用过程。
• 对话历史：跟踪并管理与 Agent 的对话。

MCP 架构

模型上下文协议（MCP）由三个主要组件组成：

1. MCP Host：寻求通过 MCP 访问数据的程序，例如 Claude Desktop、IDE 或 LangChain/LangGraph。

2. MCP Client：一个与服务器保持 1:1 连接的协议客户端，充当 Host 与 Server 之间的中介。

3. MCP Server：一个轻量级程序，通过标准化的模型上下文协议暴露特定功能，作为主要的数据源。

使用 Docker 快速启动

你可以通过 Docker 轻松运行本项目，而无需设置本地 Python 环境。

前置要求（Docker Desktop）

通过以下链接安装 Docker Desktop：

• 安装 Docker Desktop

使用 Docker Compose 运行

1. 进入 dockers 目录

cd dockers

2. 在项目根目录创建 .env 文件并填入你的 API keys。

cp .env.example .env

在 .env 文件中填入你获取的 API keys。

（注意）并非所有 API keys 都是必需的，只需填入你需要的即可。

• ANTHROPIC_API_KEY：如果填入 Anthropic API key，可以使用 "claude-3-7-sonnet-latest", "claude-3-5-sonnet-latest", "claude-3-haiku-latest" 模型。
• OPENAI_API_KEY：如果填入 OpenAI API key，可以使用 "gpt-4o", "gpt-4o-mini" 模型。
• LANGSMITH_API_KEY：如果填入 LangSmith API key，可以使用 LangSmith 追踪功能。

ANTHROPIC_API_KEY=your_anthropic_api_key
OPENAI_API_KEY=your_openai_api_key
LANGSMITH_API_KEY=your_langsmith_api_key
LANGSMITH_TRACING=true
LANGSMITH_ENDPOINT=https://api.smith.langchain.com
LANGSMITH_PROJECT=LangGraph-MCP-Agents

若需使用登录功能，请设置 USE_LOGIN 为 true 并输入 USER_ID 和 USER_PASSWORD。

USE_LOGIN=true
USER_ID=admin
USER_PASSWORD=admin123

如果不想使用登录功能，将 USE_LOGIN 设置为 false。

USE_LOGIN=false

3. 选择与你的系统架构相匹配的 Docker Compose 文件。

AMD64/x86_64 架构（Intel/AMD 处理器）

# 运行容器
docker compose -f docker-compose.yaml up -d

ARM64 架构（Apple Silicon M1/M2/M3/M4）

# 运行容器
docker compose -f docker-compose-mac.yaml up -d

4. 在浏览器访问 http://localhost:8585 即可使用应用程序。

（注意）

• 如果需要修改端口或其他设置，请在构建前编辑 docker-compose.yaml 文件。

直接从源代码安装

1. 克隆此仓库

git clone https://github.com/teddynote-lab/langgraph-mcp-agents.git
cd langgraph-mcp-agents

2. 创建虚拟环境并使用 uv 安装依赖

uv venv
uv pip install -r requirements.txt
source .venv/bin/activate  # Windows 用户请使用: .venv\Scripts\activate

3. 创建 .env 文件并填入 API keys（从 .env.example 复制）

cp .env.example .env

在 .env 文件中填入你获取的 API keys。

（注意）并非所有 API keys 都是必需的，只需填入你需要的即可。

• ANTHROPIC_API_KEY：如果填入 Anthropic API key，可以使用 "claude-3-7-sonnet-latest", "claude-3-5-sonnet-latest", "claude-3-haiku-latest" 模型。
• OPENAI_API_KEY：如果填入 OpenAI API key，可以使用 "gpt-4o", "gpt-4o-mini" 模型。
• LANGSMITH_API_KEY：如果填入 LangSmith API key，可以使用 LangSmith 追踪功能。