星战科技xingzhan.cloud
返回市场
房屋-MCP管理器

房屋-MCP管理器

作者：houseworthe4 星标更新：2025-11-04
安装使用来源：spider==github.com

项目介绍

House MCP Manager

适用于AI编码代理的通用MCP服务器管理工具

这是一个强大的CLI工具，用于跨多个AI编码工具（如Claude Code、Cursor、Cline、Continue）管理MCP服务器，并优化您的令牌使用。

House套件的一部分

House MCP Manager是Claude Code工具套件的一部分：

  • house-code - 通过子代理上下文清理减少令牌的Claude Code克隆
  • house-agents - 隔离重操作的子代理框架（节省95%以上的令牌）
  • house-mcp-manager（此工具）- 通用MCP服务器管理

问题

AI编码代理在启动时加载所有已配置的MCP服务器，在您开始编写代码之前就消耗了大量的上下文窗口。某些服务器如Canvas可以消耗78,000+令牌——这几乎是您200K上下文预算的40%！

MCP服务器状态

之前：在您编写一行代码之前，MCP服务器已经消耗了127K令牌

多个高度评价的GitHub问题（#6638，#5722，#7068，[#7936](https://github.com/anthropics/claude-code/issues/7936）显示社区希望更好地管理MCP，但目前还没有官方解决方案。

解决方案

house-mcp-manager与任何启用MCP的工具一起工作，让您能够快速启用/禁用服务器，查看令牌使用情况，保存配置文件，并优化您的上下文窗口——所有这些都不需要手动编辑JSON文件。

支持的工具

  • Claude Code - Anthropic的官方CLI
  • Cursor - 以AI为中心的代码编辑器
  • Cline - 流行的VS Code扩展
  • Continue - 即将推出
  • Zed - 即将推出

该工具会自动检测您已安装的哪些MCP启用工具，并相应地进行管理。

功能

  • 通用 - 适用于Claude Code、Cursor、Cline等
  • 自动检测 - 自动查找已安装的MCP工具
  • 项目级配置 - 按项目管理MCP服务器，从用户级配置继承
  • 快速启用/禁用 - 立即切换服务器的开启/关闭状态
  • 令牌跟踪 - 查看每个服务器消耗的确切令牌数量
  • 交互模式 - 用于批量管理的漂亮复选框界面
  • 配置文件 - 保存和加载不同的服务器配置
  • 安全 - 在任何修改之前自动备份
  • 快速 - 不需要重启或手动编辑配置

使用Claude Code快速设置

将以下提示复制并粘贴到Claude Code中以自动安装house-mcp-manager：

请帮我安装house-mcp-manager：

1. 从https://github.com/houseworthe/house-mcp-manager克隆仓库
2. 导航到克隆的目录
3. 运行npm install来安装依赖项
4. 运行npm run build来编译TypeScript
5. 运行npm link使house-mcp-manager命令全局可用
6. 通过运行：house-mcp-manager --help验证安装
7. 通过运行：house-mcp-manager status显示我的当前MCP服务器状态

安装后，请解释house-mcp-manager的作用并向我展示我可以使用的键入命令。

安装

选项1：克隆&链接（推荐）

git clone https://github.com/houseworthe/house-mcp-manager.git
cd house-mcp-manager
npm install
npm run build
npm link

现在您可以从任何地方使用house-mcp-manager！

选项2：从源运行

git clone https://github.com/houseworthe/house-mcp-manager.git
cd house-mcp-manager
npm install
npm run dev <command>

未来：npm全局安装（即将推出）

npm install -g house-mcp-manager

快速入门

检测已安装的工具

# 查看已安装的哪些MCP启用工具
house-mcp-manager detect

查看当前设置

# 列出所有服务器（自动检测工具）
house-mcp-manager list

# 查看详细的令牌估计值
house-mcp-manager status

# 管理特定工具
house-mcp-manager --tool=cline list
house-mcp-manager --tool=claude status

启用/禁用服务器

# 禁用一个重服务器
house-mcp-manager disable canvas-mcp-server

# 需要时重新启用它
house-mcp-manager enable canvas-mcp-server

交互模式（推荐）

# 启动交互式复选框界面
house-mcp-manager interactive

# 或者只需：
house-mcp-manager

这将显示所有服务器及其令牌估计值。使用↑/↓导航，Space切换，Enter确认。

配置文件 - 保存您喜欢的配置

# 将当前设置保存为"minimal"
house-mcp-manager profile save minimal

# 在配置之间切换
house-mcp-manager profile load minimal
house-mcp-manager profile load full

# 创建预构建配置文件
house-mcp-manager profile init

# 查看所有保存的配置文件
house-mcp-manager profile list

# 删除一个配置文件
house-mcp-manager profile delete old-config

命令

命令描述
house-mcp-manager detect检测已安装的MCP启用工具
house-mcp-manager list列出所有MCP服务器（启用/禁用）
house-mcp-manager status显示带有令牌估计值的详细状态
house-mcp-manager disable <server>禁用特定服务器
house-mcp-manager enable <server>启用特定服务器
house-mcp-manager interactive启动交互式复选框模式
house-mcp-manager profile save <name>将当前配置保存为配置文件
house-mcp-manager profile load <name>加载保存的配置文件
house-m- cp-manager profile list列出所有保存的配置文件
house-mcp-manager profile delete <name>删除配置文件
house-mcp-manager profile init创建预构建配置文件
house-mcp-manager config显示MCP配置文件路径
house-mcp-manager --tool=<id> <command>管理特定工具
house-mcp-manager --scope=<user|project|auto> <command>控制配置范围（默认：自动）
house-mcp-manager --project-path=<path> <command>指定项目路径以进行项目级配置
house-mcp-manager --help显示帮助

多工具管理

# 自动检测要管理的工具
house-mcp-manager status

# 显式管理Claude Code
house-mcp-manager --tool=claude status

# 管理Cursor IDE
house-mcp-manager --tool=cursor list

# 管理Cline（VS Code扩展）
house-mcp-manager --tool=cline list

# 查看检测到的工具
house-mcp-manager detect

项目级配置

House MCP Manager支持在两个级别管理MCP服务器：

  • 用户级（全局）：默认应用于所有项目
  • 项目级：覆盖特定项目的用户设置

范围管理

# 自动检测（默认）：如果检测到项目配置，则使用项目配置，否则使用用户级配置
house-mcp-manager list

# 显式用户级
house-mcp-manager list --scope=user

# 显式项目级
house-mcp-manager list --scope=project

# 特定项目路径
house-mcp-manager --project-path=/path/to/project list --scope=project

继承行为

当使用项目范围时，服务器被分类为：

  • 继承：来自用户级配置的服务器（自动可用）
  • 覆盖：项目特定版本的用户服务器（配置不同）
  • 添加：仅为此项目启用的服务器
  • 禁用：仅为此项目禁用的服务器（继承的服务器可以被禁用）

示例：项目级工作流程

# 1. 检查当前状态（显示合并视图及继承）
cd /path/to/my-project
house-mcp-manager status --scope=project

# 输出显示：
# 从用户继承：
#   github         ~15k令牌    12个工具
# 项目添加：
#   puppeteer      ~8k令牌     7个工具

# 2. 仅为此项目禁用一个重的继承服务器
house-mcp-manager disable canvas-mcp-server --scope=project

# 3. 启用一个项目特定的服务器
house-mcp-manager enable puppeteer --scope=project

# 4. 查看项目级配置
house-mcp-manager list --scope=project

项目级特性

  • 智能自动检测：自动使用项目配置，如果没有检测到则回退到用户级配置
  • 无操作保护：尝试启用一个已经继承的服务器时会显示一条信息性消息
  • 令牌分解：按继承类别查看令牌使用情况（继承 vs. 项目添加）
  • 分组显示：视觉区分继承和项目级服务器

项目配置存储

对于Claude Code，项目配置存储在~/.claude.json下的projects部分：

{
  "mcpServers": { /* 用户级服务器 */ },
  "projects": {
    "/path/to/project": {
      "mcpServers": { /* 项目特定服务器 */ },
      "disabledMcpServers": ["canvas"]  /* 按名称禁用 */
    }
  }
}

示例工作流程

# 1. 检查当前令牌使用情况
house-mcp-manager status
# 输出：总活动令牌使用量：~127,000令牌 ⚠️

# 2. 禁用未使用的重服务器
house-mcp-manager interactive
# 取消选择canvas、notion、puppeteer

# 3. 检查新的使用情况
house-mcp-manager status
# 输出：总活动令牌使用量：~14,000令牌 ✓

# 4. 保存这个最小配置
house-mcp-manager profile save coding-only

# 5. 后来，当您需要所有功能时
house-mcp-manager profile load full

实际影响

之前：

总活动令牌使用量：~127,000令牌
上下文可用量：73,000令牌（预算的36%）

禁用未使用的服务器之后：

总活动令牌使用量：~14,000令牌
上下文可用量：186,000令牌（预算的93%）

节省了113,000令牌——足够用于：

  • 更大的文件操作
  • 更多的上下文保留
  • 更好的多步推理
  • 更快的响应

工作原理

house-mcp-manager使用适配器模式支持多种启用MCP的工具：

  • Claude Code：管理~/.claude.json，内部使用_disabled_mcpServers字段
  • Cursor：管理~/.cursor/mcp.json中的活动服务器。禁用的服务器存储在单独的~/.cursor/mcp-disabled.json文件中，以避免污染原生Cursor配置。备份保存在~/.claude-mcp-backups/cursor/
  • Cline：使用命名空间键cline.mcpServers和cline._disabled_mcpServers管理VS Code settings.json
  • Continue：管理~/.continue/config.json（即将推出）
  • Zed：管理Zed设置（即将推出）

对于所有工具，服务器在启用和禁用部分之间移动，而不是删除，确保没有数据丢失。

安全功能：

  • 修改前自动备份
  • 每次更改后进行JSON验证
  • 没有数据丢失——服务器被移动，而不是删除
  • 通过备份轻松回滚

测试

测试套件：139个测试（130个通过，93.5%） 覆盖率：核心功能完全测试 持续时间：完整套件约300毫秒

npm test              # 运行所有测试
npm run test:watch    # 监控模式
npm run test:coverage # 覆盖报告

请参阅TESTING.md获取完整的测试文档。

令牌估计

令牌估计基于：

  1. 已知服务器 - 社区报告的实际值
  2. 启发法 - 根据服务器类型进行智能猜测
  3. 保守估计 - 过高估计比过低估计更好

示例已知服务器：

  • canvas-mcp-server：~78,000令牌
  • notion：~35,000令牌
  • github：~15,000令牌
  • puppeteer：~8,000令牌

估计可能不是100%准确，但它们为您提供了一个相对令牌消耗的良好理解。

贡献

此工具旨在解决MCP生态系统中的实际问题。如果您有：

  • 错误报告
  • 功能请求
  • 服务器的准确令牌计数
  • 新工具适配器（Continue、Zed等）
  • UI改进

请在GitHub上打开一个问题或PR！

许可证

MIT许可证 - 详情见LICENSE文件。