使用说明

项目简介

MCPM (Model Context Protocol Manager) 主要用于简化 MCP 服务器的管理。它包含一个核心组件 MCPM Router，该路由器本身可以作为一个 MCP 服务器运行，并将后端连接到多个独立的 MCP 服务器。通过 MCPM Router，LLM 客户端只需连接到路由器，即可访问由路由器聚合的多个 MCP 服务器的功能，从而实现上下文信息和工具的统一访问入口。

主要功能点

MCP 协议路由: 充当 MCP 服务器，接收客户端的 JSON-RPC 请求，并将请求智能路由到后端配置的多个 MCP 服务器。
服务器聚合: 将多个独立的 MCP 服务器的功能（资源、工具、Prompt）整合到单一端点，方便客户端管理和访问。
会话管理和能力声明: 路由器自身负责 MCP 会话管理，并声明聚合后 MCP 服务器的能力。
动态配置: 通过 MCPM 命令行工具 ('mcpm') 管理后端 MCP 服务器的配置，支持动态添加、移除和更新服务器。
Profile 支持: 集成 MCPM Profile 功能，允许用户通过 Profile 切换不同的后端 MCP 服务器组合。

安装步骤

由于 MCPM Router 是 MCPM 工具套件的一部分，您需要先安装 MCPM 命令行工具。MCPM 提供了多种安装方式，推荐使用 'pipx' 或 'brew' 进行安装。

使用 pipx (推荐):

pipx install mcpm

使用 Homebrew (macOS):

brew install mcpm

使用 pip:

pip install mcpm

使用 Shell 脚本 (一键安装):

curl -sSL https://mcpm.sh/install | bash

安装完成后，您可以使用 'mcpm' 命令来管理 MCPM Router。

服务器配置

启动命令 (command): 'uvicorn' 或 'python' 启动参数 (args): 根据您的安装方式和环境选择，以下是两种常见的启动参数示例。

示例 1: 使用 'uvicorn' 启动 (推荐)

{
  "server name": "mcpm-router",
  "command": "uvicorn",
  "args": [
    "mcpm.router.app:app",
    "--host",
    "localhost",
    "--port",
    "6276"
  ],
  "注释": "使用 uvicorn 启动 MCPM Router，监听本地 6276 端口"
}

示例 2: 使用 'python' 模块启动

{
  "server name": "mcpm-router",
  "command": "python",
  "args": [
    "-m",
    "uvicorn",
    "mcpm.router.app:app",
    "--host",
    "localhost",
    "--port",
    "6276"
  ],
  "注释": "使用 python -m uvicorn 启动 MCPM Router，监听本地 6276 端口"
}

参数说明:

'command': 指定启动服务器的命令，可以是 'uvicorn' 或 'python'。
'args': 启动命令的参数，包括：
- '"mcpm.router.app:app"': 指定运行的 Python 模块和 Starlette 应用实例。
- '"--host", "localhost"': 指定监听的主机地址为本地主机。
- '"--port", "6276"': 指定监听的端口为 6276。

注意:

MCPM Router 默认监听 'localhost:6276'，您可以根据需要修改 'host' 和 'port' 参数。
实际配置时，MCP 客户端通常只需要配置 'command' 和 'args' 即可连接到 MCPM Router 服务。

基本使用方法

启动 MCPM Router 服务: 在终端中运行以下命令启动 MCPM Router 后台服务：
```
mcpm router on
```
您可以使用 'mcpm router status' 命令检查 Router 运行状态。
配置 MCP 客户端连接: 在您的 MCP 客户端应用中，配置连接到 MCP 服务器的信息。对于 MCPM Router，您需要配置客户端连接到 Router 的地址和端口，例如 'http://localhost:6276/sse'。
管理后端 MCP 服务器: 使用 'mcpm' 命令管理后端连接的 MCP 服务器，例如使用 'mcpm add <server_url>' 添加新的 MCP 服务器配置，使用 'mcpm ls' 列出已配置的服务器等。您还可以使用 Profile 功能 ('mcpm profile') 来管理不同的服务器组合。

通过 MCPM Router，您可以更方便地管理和使用多个 MCP 服务器，为您的 LLM 应用提供统一的上下文服务入口。

关键词