MCP服务器管理工具

MCP Helpy Helperton是一款基于文本界面的工具,用于管理Claude Code中的MCP服务器配置,通过启用/禁用服务器来优化上下文空间的使用。

  • by burnsbert
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 burnsbert/mcp-helperton

使用说明

MCP帮助助手

一个基于文本的UI工具,用于管理Claude Code全局配置中的MCP(模型上下文协议)服务器。

为什么使用这个?

每个启用的MCP服务器都会占用Claude Code中的上下文空间。如果您配置了许多MCP,但只定期使用少数MCP,则未使用的MCP仍会占用宝贵的上下文令牌。

MCP Helpy Helperton让您:

  • 最大化上下文空间 通过禁用当前未使用的MCP
  • 保留配置 这样就不会丢失复杂的MCP设置(API键、路径、环境变量)
  • 快速重新启用 在需要时使用任何MCP,无需手动重新配置
  • 在工作流之间切换 通过为不同任务启用不同的MCP组合

特性

  • 可视化MCP管理:在一个地方查看所有启用和禁用的MCP服务器
  • 轻松切换:使用箭头键导航,使用Enter键启用/禁用服务器
  • 永久存储:禁用的MCP存储在本地,并在会话中存活
  • 无损检测:原始MCP配置(包括env变量、args等)完全保留
  • 自动备份:首次使用时创建配置的备份

安装

看 安装.md 了解详细的安装说明。

快速安装:

npm install -g mcp-helperton

用法

mcp-helperton

控制

关键 行动
↑ / ↓ 向上/向下导航
Enter 切换所选MCP(启用/禁用)
s 保存并退出
q 退出而不保存

显示

┌───────────────────────────────────────────────────────┐
│                 MCP Helpy Helperton                   │
├───────────────────────────────────────────────────────┤
│   [✓] slack                                           │
│   [✓] jira-read                                       │
│  >[✓] servicetrade-mcp                   ← selected   │
│   [ ] github-mcp                         ← disabled   │
│   [ ] filesystem                                      │
├───────────────────────────────────────────────────────┤
│   ↑↓ Navigate   Enter Toggle   s Save & Quit   q Quit │
└───────────────────────────────────────────────────────┘
  • [✓] =已启用(在Claude代码配置中)
  • [ ] =已禁用(存储在helpy配置中)
  • > =当前选定

运作原理

  1. 阅读 Claude Code的全局MCP配置来自 ~/.claude.json

  2. 商店 禁用MCP ~/.config/mcp-helperton/helpy.json

  3. 禁用时:从Claude Code配置中删除MCP并保存完整配置以帮助存储

  4. 启用时:将MCP从helpy存储还原回Claude代码配置

  5. 备份:首次保存时,创建 ~/.claude.json.helperton-backup 为了安全

配置

该工具将数据存储在:

平台 路径
macOS/Linux ~/.config/mcp-helperton/helpy.json
窗户 %APPDATA%\mcp-helperton\helpy.json

helpy.json结构

{
  "disabledServers": {
    "server-name": {
      "command": "/path/to/server",
      "args": ["arg1", "arg2"],
      "env": {
        "API_KEY": "..."
      }
    }
  }
}

需求

  • Node.js 18+
  • 已安装Claude Code CLI

许可证

麻省理工学院

贡献

欢迎投稿!请在GitHub上打开问题或PR。