MCP Manager

MCP Manager

MCP Manager 充当大模型与 MCP 服务之间的桥梁。它支持通过聊天补全 API 使用自然语言提示词与远程和本地 API 交互。

可定义具有不同配置的工作区，从而通过单个 MCP Manager 实例连接到不同的大模型端点和 MCP 服务（可能使用不同的端口、地址或路径）。

什么是 MCP 服务？

MCP 服务是一种中间件，目前位于大模型和 API 之间，让大模型能够检查有哪些可用工具可用于执行用户提示词中可能要求的操作，并决定采取行动，而不只是向用户提供答案。MCP 服务会将模型执行某项操作的“意图”转化为实际操作，无论是更改还是查询某个系统。

如需了解更多信息，请访问 https://mcp.so，并滚动到页面底部查看常见问题解答。

功能

• 集成多种大模型（目前支持 Gemini、Azure OpenAI）
• 支持大模型与 MCP 服务交互
• 通过单个 YAML 文件灵活配置工作区
• 支持 API Key 身份验证（计划支持 OAuth 2.0）
• 提供简单的 HTTP API，以 OpenAI 格式发送提示词

安装

只需在 Release 部分的 Packages 中下载适用于你操作系统的文件，即可开始使用。

配置

配置通过 YAML 文件管理（默认位于运行目录下的 config.yaml）。可以使用 MCP_MANAGER_CONFIG 环境变量覆盖该路径。

带注释的示例配置文件见 config.example.yaml。

身份验证

目前仅支持 API Key 身份验证，可在模型设置中进行配置。计划支持 OAuth 2.0。

大模型配置

配置因大模型提供方而异：

• Gemini

  • 需要 API Key
  • API 端点可在 Gemini 文档中找到（使用基础 REST 端点）。应通过 MCP Manager 配置 API Key，而不要将其包含在 URL 中

• Azure OpenAI

  • 需要已部署的模型
  • 资源端点
  • API 版本（请参阅可用版本）
  • 已部署的模型名称
  • API Key

使用方法

1. 启动服务

mcp-manager

也可以使用不同的配置路径

export MCP_MANAGER_CONFIG=/path/to/your/config.yaml
mcp-manager

2. 通过 HTTP 调用发送提示词（假设使用默认端口）

下面是一个 curl 示例，使用为 /azure 配置的工作区和 filesystem MCP 服务：

curl http://localhost:7000/azure -H "Content-Type: application/json" -d '{"messages": [{"role":"user","content":"Check if the file /tmp/abc exists"}]}'

输出大致如下：

{
  "messages": [
    {
      "role": "user",
      "content": "Check if the file /tmp/abc exists"
    },
    {
      "role": "assistant",
      "tool_calls": [
        {
          "name": "get_file_info",
          "id": "cGAjCuzqBBnUx2J2dpjpDbZg",
          "arguments": {
            "path": "/tmp/abc"
          }
        }
      ]
    },
    {
      "type": "FunctionCallOutput",
      "call_id": "cGAjCuzqBBnUx2J2dpjpDbZg",
      "output": "Error: ENOENT: no such file or directory, stat '/tmp/abc'"
    },
    {
      "role": "assistant",
      "content": "The file /tmp/abc does not exist."
    }
  ],
  "temperature": null,
  "max_tokens": null,
  "top_p": null,
  "tools": null
}

我们会得到用户、模型、MCP Manager 和 MCP 服务之间交换的所有消息的完整列表。

限制

• 支持的大模型

  • Gemini
  • Azure OpenAI
  • （计划支持：Claude 和 OpenAI）

• 支持的 MCP 服务连接

  • 本地 MCP 服务
  • （计划支持：远程 MCP 服务）

贡献

欢迎贡献，请参阅 CONTRIBUTING.md

主要开发工作在 GitLab 上进行。请在此提交问题和合并请求。我们在 GitHub 上维护了一个镜像仓库，在 GitHub 上提交的问题将由我们手动迁移至 GitLab。

欢迎通过 GitLab Issues 提交错误报告和功能请求。

许可证

本项目采用 GNU GPLv3 许可证