House MCP Manager

MCP经理

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

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

房子套房的一部分

众议院MCP经理是 套房 Claude Code的工具：

• 房屋代码 -Claude代码克隆，通过子代理上下文清理器减少令牌
• 房屋经纪人 -隔离繁重操作的子代理框架（节省95%以上的令牌）
• 房屋mcp经理 （此工具）-通用MCP服务器管理

问题

AI编码代理在启动时加载所有配置的MCP服务器，在您开始编码之前就消耗了大量的上下文窗口。像Canvas这样的服务器可以消耗 78000+代币 -这几乎是你20万上下文预算的40%！

*之前：MCP服务器在编写一行代码之前消耗127K令牌*

解决方案

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

支持的工具

• 克劳德代码 -Anthropic官方CLI
• 光标 -AI第一代码编辑器
• 克莱恩 -流行的VS代码扩展
• 继续 -即将推出
• 泽德 -即将推出

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

特性

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

使用Claude代码快速设置

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

Please help me install house-mcp-manager:

1. Clone the repository from https://github.com/houseworthe/house-mcp-manager
2. Navigate into the cloned directory
3. Run npm install to install dependencies
4. Run npm run build to compile the TypeScript
5. Run npm link to make the house-mcp-manager command available globally
6. Verify the installation by running: house-mcp-manager --help
7. Show me my current MCP server status by running: house-mcp-manager status

After installation, explain what house-mcp-manager does and show me the key commands I can use.

安装

选项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 

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

npm install -g house-mcp-manager

快速开始

检测已安装的工具

# See which MCP-enabled tools are installed
house-mcp-manager detect

查看当前设置

# List all servers (auto-detects tool)
house-mcp-manager list

# View detailed token estimates
house-mcp-manager status

# Manage a specific tool
house-mcp-manager --tool=cline list
house-mcp-manager --tool=claude status

启用/禁用服务器

# Disable a heavy server
house-mcp-manager disable canvas-mcp-server

# Enable it back when needed
house-mcp-manager enable canvas-mcp-server

交互模式（推荐）

# Launch interactive checkbox interface
house-mcp-manager interactive

# Or just:
house-mcp-manager

这显示了所有带有令牌估计的服务器。 Use ↑/↓ 导航，空格切换，Enter确认。

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

# Save current setup as "minimal"
house-mcp-manager profile save minimal

# Switch between configurations
house-mcp-manager profile load minimal
house-mcp-manager profile load full

# Create pre-built profiles
house-mcp-manager profile init

# View all saved profiles
house-mcp-manager profile list

# Delete a profile
house-mcp-manager profile delete old-config

命令

多工具管理

# Auto-detect which tool to manage
house-mcp-manager status

# Explicitly manage Claude Code
house-mcp-manager --tool=claude status

# Manage Cursor IDE
house-mcp-manager --tool=cursor list

# Manage Cline (VS Code extension)
house-mcp-manager --tool=cline list

# See which tools are detected
house-mcp-manager detect

项目级配置

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

• 用户级别 （全局）：默认情况下适用于所有项目
• 项目级别：覆盖特定项目的用户设置

范围管理

# Auto-detect (default): Use project config if detected, otherwise user-level
house-mcp-manager list

# Explicit user-level
house-mcp-manager list --scope=user

# Explicit project-level
house-mcp-manager list --scope=project

# Specific project path
house-mcp-manager --project-path=/path/to/project list --scope=project

继承行为

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

• 遗传的：用户级配置中的服务器（自动可用）
• 否决：用户服务器的项目特定版本（配置不同）
• 添加物：仅为此项目启用服务器
• 残疾：仅为此项目禁用服务器（可以禁用继承的服务器）

示例：项目级工作流

# 1. Check current status (shows merged view with inheritance)
cd /path/to/my-project
house-mcp-manager status --scope=project

# Output shows:
# Inherited from User:
#   github         ~15k tokens    12 tools
# Project Additions:
#   puppeteer      ~8k tokens     7 tools

# 2. Disable a heavy inherited server for this project only
house-mcp-manager disable canvas-mcp-server --scope=project

# 3. Enable a project-specific server
house-mcp-manager enable puppeteer --scope=project

# 4. View project-level config
house-mcp-manager list --scope=project

项目级功能

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

项目配置存储

对于Claude Code，项目配置存储在 ~/.claude.json 低于 projects 章节：

{
  "mcpServers": { /* user-level servers */ },
  "projects": {
    "/path/to/project": {
      "mcpServers": { /* project-specific servers */ },
      "disabledMcpServers": ["canvas"]  /* disabled by name */
    }
  }
}

工作流示例

# 1. Check current token usage
house-mcp-manager status
# Output: Total Active Token Usage: ~127,000 tokens ⚠️

# 2. Disable heavy servers you're not using
house-mcp-manager interactive
# Uncheck canvas, notion, puppeteer

# 3. Check new usage
house-mcp-manager status
# Output: Total Active Token Usage: ~14,000 tokens ✓

# 4. Save this minimal config
house-mcp-manager profile save coding-only

# 5. Later, when you need all features
house-mcp-manager profile load full

现实世界影响

之前：

Total Active Token Usage: ~127,000 tokens
Context Available: 73,000 tokens (36% of budget)

禁用未使用的服务器后：

Total Active Token Usage: ~14,000 tokens
Context Available: 186,000 tokens (93% of budget)

节省了113000个代币 -足够：

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

运作原理

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

• 克劳德代码：管理 ~/.claude.json 与内部 _disabled_mcpServers 领域
• 光标：管理 ~/.cursor/mcp.json 对于活动服务器。禁用的服务器存储在单独的 ~/.cursor/mcp-disabled.json 文件，以避免污染本机Cursor配置。备份保存到 ~/.claude-mcp-backups/cursor/
• 克莱恩：管理VS代码 settings.json 使用 cline.mcpServers 和 cline._disabled_mcpServers 命名空间键
• 继续：管理 ~/.continue/config.json （即将推出）
• 泽德：管理Zed设置（即将推出）

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

安全特性：

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

测试

测试套件：139次测试（130次通过，93.5%） 覆盖：核心功能已全面测试 持续时间：全套房约300ms

npm test              # Run all tests
npm run test:watch    # Watch mode
npm run test:coverage # Coverage report

看 测试.md 获取完整的测试文档。

代币估算

代币估算基于：

1. 已知服务器 -社区实际报告值
2. 启发法 -基于服务器类型的智能猜测
3. 保守估计 -高估总比低估好

已知服务器示例：

• canvas-mcp-server：约78000个代币
• notion：约35000个代币
• github：约15000个代币
• puppeteer：约8000个代币

估计可能不是100%准确，但它们可以让你对相对代币消费有一个扎实的了解。

贡献

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

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

请在上打开问题或PR !

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。