使用说明
项目简介
本项目实现了一个MCP网关服务器,它作为LangGraph Agent Team的前端,负责管理和聚合多个MCP服务器提供的工具。Agent 可以通过这个网关访问文件系统、内存数据库等多种能力,从而完成代码生成和管理任务。
主要功能点
- MCP网关服务: 管理多个MCP服务器进程,提供统一的API入口。
- 工具聚合: 汇总并暴露来自多个MCP服务器的工具。
- HTTP接口: 通过简单的HTTP接口与MCP客户端通信。
- 支持多种MCP服务器: 默认配置支持文件系统和内存数据库类型的MCP服务器,可以扩展支持更多类型的MCP服务器。
安装步骤
- 安装 agent 和 gateway 包:
pip install -e . cd gateway pip install -e . cd .. - 配置环境变量: 根据需要配置 LLM 提供商的 API 密钥,例如 OpenAI, Anthropic, OpenRouter, Google 等。具体环境变量请参考 'README.md' 中的 "2. Configure Environment Variables" 部分。
服务器配置
MCP网关服务器的配置文件为 'gateway/config.json'。默认配置启动了 'filesystem' 和 'memory' 两个MCP服务器。
{ "mcp": { "servers": { "filesystem": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-filesystem", "/path/to/directory" // 文件系统MCP服务器的根目录,请替换为实际路径 ] }, "memory": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-memory" ] } } } }
- 'servers': 配置要启动的MCP服务器。
- 'filesystem': 文件系统MCP服务器配置。
- 'command': 启动命令,通常为 'npx'。
- 'args': 启动参数,包括 '-y' (自动安装 npm 包), '@modelcontextprotocol/server-filesystem' (服务器 npm 包名), 和文件系统根目录路径。请务必将 '/path/to/directory' 替换为您希望文件系统服务器访问的实际目录路径。
- 'memory': 内存数据库MCP服务器配置。
- 'command': 启动命令,通常为 'npx'。
- 'args': 启动参数,包括 '-y' (自动安装 npm 包) 和 '@modelcontextprotocol/server-memory' (服务器 npm 包名)。
- 'filesystem': 文件系统MCP服务器配置。
您可以根据需要,参考 官方 MCP 服务器仓库 添加更多类型的MCP服务器。
基本使用方法
-
启动网关服务器:
cd gateway python -m mcp_gateway.server服务器默认在 8808 端口启动。
-
配置 Agent: Agent 的网关连接配置在 'langgraph.json' 文件中。确认 'mcp.gateway_url' 配置为网关服务器地址 (默认为 'http://localhost:8808')。
-
使用 Agent: 在 LangGraph Studio 中打开项目文件夹即可开始使用 Agent。Agent 会自动连接到网关服务器,发现并使用可用的工具。
信息
分类
AI与计算