使用说明

项目简介

本项目实现了一个MCP网关服务器,它作为LangGraph Agent Team的前端,负责管理和聚合多个MCP服务器提供的工具。Agent 可以通过这个网关访问文件系统、内存数据库等多种能力,从而完成代码生成和管理任务。

主要功能点

  • MCP网关服务: 管理多个MCP服务器进程,提供统一的API入口。
  • 工具聚合: 汇总并暴露来自多个MCP服务器的工具。
  • HTTP接口: 通过简单的HTTP接口与MCP客户端通信。
  • 支持多种MCP服务器: 默认配置支持文件系统和内存数据库类型的MCP服务器,可以扩展支持更多类型的MCP服务器。

安装步骤

  1. 安装 agent 和 gateway 包:
    pip install -e .
    cd gateway
    pip install -e .
    cd ..
  2. 配置环境变量: 根据需要配置 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 包名)。

您可以根据需要,参考 官方 MCP 服务器仓库 添加更多类型的MCP服务器。

基本使用方法

  1. 启动网关服务器:

    cd gateway
    python -m mcp_gateway.server

    服务器默认在 8808 端口启动。

  2. 配置 Agent: Agent 的网关连接配置在 'langgraph.json' 文件中。确认 'mcp.gateway_url' 配置为网关服务器地址 (默认为 'http://localhost:8808')。

  3. 使用 Agent: 在 LangGraph Studio 中打开项目文件夹即可开始使用 Agent。Agent 会自动连接到网关服务器,发现并使用可用的工具。

信息

分类

AI与计算