AI导哈

MCP服务器管理工具

一个轻量级CLI工具，用于管理Claude MCP服务器，支持快速切换配置并保留设置。

  • by LoneExile
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 LoneExile/lmcp

使用说明

lmcp

L重量轻 主控程序 Manager-一个轻量级的CLI工具，用于管理您的Claude MCP服务器

切换 模型上下文协议（MCP） 在不丢失配置的情况下打开和关闭服务器。非常适合管理多个MCP服务器并在不同设置之间快速切换。

✨ 特性

  • 🎯 交互式用户界面 -用于切换服务器的直观复选框界面
  • 💾 配置保存 -禁用的服务器被安全存储，不会被删除
  • ⚡ 快速切换 -无需编辑JSON文件即可快速启用/禁用服务器
  • 🔄 批量操作 -切换所有服务器或使用单个键反转选择
  • 🎨 颜色编码状态 -活动（✓）和禁用（✗）服务器的视觉指示器
  • 🛡️ 安全默认值 -永远不要覆盖现有配置

📦 安装

全局安装（推荐）

npm install -g lmcp

使用npx（无需安装）

npx lmcp

来源

git clone https://github.com/loneexile/lmcp.git
cd lmcp
pnpm install
pnpm build
pnpm link --global

🚀 快速开始

只需运行以下命令：

lmcp

您将看到一个交互式界面：

❯ lmcp
MCP Server Manager
Select which MCP servers should be active in Claude:

? Toggle MCP servers (active servers will be in ~/.claude.json):
❯◉ ✓ github (active)
 ◉ ✓ context7 (active)
 ◯ ✗ playwright (disabled)
 ◯ ✗ postgres (disabled)
 ◯ ✗ docker-mcp (disabled)

↑↓ navigate • space select • a all • i invert • ⏎ submit

键盘快捷键

关键 行动
↑ ↓ 在服务器间导航
Space 切换单个服务器
a 切换所有服务器
i 反转当前选择
Enter 应用更改
Ctrl+C 取消而不更改

💡 运作原理

lmcp 管理两个配置文件：

  1. ~/.claude.json -包含您的活动MCP服务器（由Claude加载）
  2. ~/.lmcp.json -存储已禁用的服务器（保留但未加载）

切换服务器时：

  • ✅ 启用 → 服务器配置已移动到 ~/.claude.json
  • ❌ 残疾 → 服务器配置已移动到 ~/.lmcp.json

您的服务器配置为 从未删除，只是在文件之间移动。这意味着您可以自由地尝试不同的服务器组合，而不会丢失设置。

工作流示例

# 1. Run lmcp
lmcp

# 2. Use spacebar to select which servers should be active
#    For example, enable only 'github' and 'context7'

# 3. Press Enter to apply

# Output:
✓ Enabled: github
✓ Enabled: context7
✗ Disabled: playwright
✗ Disabled: postgres

Configuration updated successfully!
Active servers: 2
Disabled servers: 2

🔧 用例

测试单个服务器

快速只启用一台服务器来测试其功能：

lmcp  # Disable all except the one you want to test

开发vs生产

为不同的环境维护单独的服务器集：

  • 开发：启用调试和测试服务器
  • 生产：仅启用基本、稳定的服务器

性能优化

Claude用更少的服务器加载更快。禁用未使用的服务器以缩短启动时间。

故障排除

当Claude的行为异常时，禁用所有服务器并逐一启用它们以识别有问题的服务器。

📚 文档

综合文档可在 /docs 目录：

📋 需求

  • Node.js 16岁或以上
  • 克劳德桌面 与现有 ~/.claude.json 配置文件
  • MCP服务器 已在中配置 ~/.claude.json

🏗️ 项目结构

lmcp/
├── src/
│   ├── index.ts      # CLI entry point
│   ├── config.ts     # Configuration file handlers
│   ├── manager.ts    # Server toggle logic
│   ├── ui.ts         # Interactive UI
│   └── types.ts      # TypeScript types
├── openspec/         # OpenSpec documentation
├── package.json
└── README.md

🛠️ 发展

设置

# Clone the repository
git clone https://github.com/loneexile/lmcp.git
cd lmcp

# Install dependencies
pnpm install

# Run in development mode
pnpm dev

# Build for production
pnpm build

# Link for local testing
pnpm link --global

脚本

pnpm build        # Compile TypeScript
pnpm dev          # Run in development mode
pnpm lint         # Run Biome linter
pnpm lint:fix     # Fix linting issues
pnpm format       # Format code with Biome
pnpm typecheck    # Type check without building

代码质量

本项目使用：

  • TypeScript 严格模式
  • 生物群系 用于裁剪和格式化
  • 制表符缩进 和 双引号

🐛 故障排除

No MCP servers found 错误

原因： 不 ~/.claude.json 或 ~/.lmcp.json 文件存在

解决方案： 确保安装了Claude Desktop，并配置了至少一个MCP服务器。看 Claude MCP文档 有关设置说明。

克劳德未反映的变化

原因： 需要重新启动Claude以重新加载配置

解决方案： 更改后退出并重新启动Claude Desktop。

权限错误

原因： 权限不足，无法读取/写入配置文件

解决方案：

# Check file permissions
ls -la ~/.claude.json ~/.lmcp.json

# Fix permissions if needed (macOS/Linux)
chmod 644 ~/.claude.json ~/.lmcp.json

🤝 贡献

欢迎投稿！请随时提交拉取请求。对于重大更改，请先打开一个问题来讨论您想要更改的内容。

📄 许可证

麻省理工学院

🔗 链接

🌟 致谢

灵感源自 克劳德ext 王。

为 克劳德桌面 和 模型上下文协议 生态系统。

由以下材料制成❤️ 通过 孤独流亡

相关 MCP