MCP服务器管理CLI

一个统一的命令行界面和守护进程,用于管理多个MCP服务器,具有现代用户体验和强大的日志功能。

  • by khaitrinhxuan
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 khaitrinhxuan/mcp-manager

使用说明

MCP管理器CLI

一个统一的CLI和守护进程,用于通过现代UX和强大的日志记录管理多个MCP服务器。

⚡ 由...驱动 CloudThinker

特性

  • 守护进程/服务架构:用于多进程管理的后台FastAPI服务器
  • 统一CLI:用于所有管理操作的交互式CLI
  • 服务器管理:启动、停止和监视多个MCP服务器
  • SSE支持:实时通信端点
  • CloudThinker集成:连接 CloudThinker人工智能代理
  • 安全API:所有操作的API密钥身份验证

快速安装

pip install mcp-manager-cli

配置

创建 .cache/mcp_config.json:

{
  "mcpServers": {
    "hackernews": {
      "command": "uvx",
      "args": ["mcp-hn"],
      "auto_start": true
    }
  }
}

快速开始

  1. 启动CLI:

    mcp-manager
    
  2. 基本命令:

    daemon start          # Start daemon (port 4123)
    server list          # List all servers
    tools list           # List available tools
    api-key             # Show API key
    help                # Show all commands
    

基本命令

命令 描述
daemon start [--port PORT] 启动守护进程(默认端口4123)
daemon stop 停止守护进程
daemon status 显示守护进程状态
server list 列出托管服务器
server reload 重新加载配置
tools list 列出所有工具
api-key 显示当前API密钥
config edit 编辑配置

API终点

  • 管理:所有终结点都需要API密钥身份验证
  • SSE流: GET /sse -所有服务器的统一流
  • 每台服务器SSE: GET /<server-name>/sse -直接访问服务器
  • 消息: POST /messages -向服务器发送消息

Docker使用

# Quick start with Docker Compose
docker-compose up -d

# Or run directly
docker run -d -p 4123:4123 \
  -v $(pwd)/.cache:/app/.cache \
  khaitrinhxuan/mcp-manager-cli:latest

安全

  • API密钥在中自动生成 .cache/mcp_manager_api_key.txt
  • 所有管理端点都需要承载令牌身份验证
  • 使用 regenerate-api-key 创建新密钥的命令

集成示例

与ngrok

ngrok http 4123

带光标

使用 超级通道:

{
  "mcpServers": {
    "mcp-manager": {
      "command": "npx",
      "args": ["-y", "supergateway", "--sse", "http://localhost:4123/sse", "--oauth2Bearer", "YOUR-API-KEY"]
    }
  }
}

CloudThinker集成

有关全面的设置指南: 官方CloudThinker文档

了解更多信息,请访问 cloudthinker.io

开发环境设置

# Clone and setup
git clone <repo-url>
cd mcp-manager
uv venv .venv
source .venv/bin/activate
uv pip install -e .

文件结构

  • 配置: .cache/mcp_config.json
  • API密钥: .cache/mcp_manager_api_key.txt
  • 日志: .cache/mcp_manager_daemon.log

许可证

MIT许可证