MCP服务器管理工具

一个用于管理MCP(Model Context Protocol)服务器的命令行工具,支持服务器安装、卸载、激活、更新、状态检查、配置备份与恢复以及问题诊断。

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

使用说明

mcp经理

用于管理MCP(模型上下文协议)服务器的简单CLI工具。

目的

  • 查看MCP服务器列表
  • 安装/删除MCP服务器
  • 启用/禁用MCP服务器(节省令牌)
  • MCP服务器更新(如brew upgrade)
  • 检查MCP服务器状态
  • 备份/还原设置
  • 诊断和故障排除设置(像brew doctor一样)

安装

cd ~/automation-toolkit/mcp-manager
uv tool install .

使用方法

查看服务器列表

# 기본 (활성화된 서버만)
mcpm list
mcpm ls  # 별칭

# 비활성화된 서버 포함
mcpm list -a
mcpm list --all

# 상세 정보 (env 포함)
mcpm list -v
mcpm list --verbose

安装/删除服务器

# uvx 서버 설치
mcpm install mcp-server-time
mcpm install mcp-server-fetch

# npx 서버 설치
mcpm install @upstash/context7-mcp
mcpm install @modelcontextprotocol/server-sequential-thinking

# 커스텀 이름으로 설치
mcpm install mcp-server-time --name my-time

# 서버 제거
mcpm uninstall time
mcpm uninstall context7

# 확인 없이 제거
mcpm uninstall time --force

启用/禁用服务器

# 서버 비활성화 (토큰 절약)
mcpm disable sequential-thinking
mcpm disable context7

# 서버 활성화
mcpm enable sequential-thinking
mcpm enable context7

更新服务器

# 전체 서버 업데이트
mcpm upgrade
mcpm up  # 별칭

# 특정 서버만 업데이트
mcpm upgrade context7
mcpm up time

检查服务器状态

# 전체 서버 체크
mcpm health

# 특정 서버만 체크
mcpm health context7

服务器详细信息

mcpm show context7
mcpm show time

备份/还原设置

# 백업 생성
mcpm backup

# 백업 목록
mcpm backup -l
mcpm backup --list

# 백업 복원
mcpm backup -r 20251202-143052
mcpm backup --restore 20251202-143052

# 백업 삭제
mcpm backup -d 1                    # ID로 특정 백업 삭제
mcpm backup -d 20251202-143052      # 타임스탬프로 삭제
mcpm backup -d 1 --force            # 확인 없이 삭제

# 백업 정리
mcpm backup --clean                 # 전체 백업 삭제
mcpm backup --clean --keep 5        # 최근 5개만 유지
mcpm backup --clean --force         # 확인 없이 전체 삭제

诊断设置

# MCP 설정 진단 및 문제 확인
mcpm doctor

命令帮助

# 전체 도움말
mcpm --help

# 특정 명령어 도움말
mcpm list --help
mcpm install --help
mcpm uninstall --help
mcpm disable --help
mcpm enable --help
mcpm upgrade --help
mcpm health --help
mcpm show --help
mcpm backup --help
mcpm doctor --help

实施原则

  • 禁止猜测,验证优先:验证所有输入
  • 禁止绕道,根本解决:直接运行subprocess
  • 禁止阿谀奉承,批判性思考:处理所有错误案例

技术堆栈

  • Python 3.10+
  • typer(CLI框架)
  • rich(输出格式化)

许可证

麻省理工学院