mcprax - Model Context Protocol Rack Manager
2025.04.16
1
JavaScriptMCP 服务器管理开发环境配置开发效率
mcprax 是一个强大的 CLI 工具，用于管理和部署 Model Context Protocol (MCP) 服务器到 Claude Desktop，作为可配置的“racks”（机架），以简化开发工作流程。它允许用户定义多个 MCP 服务器配置，将这些服务器分组到“racks”中，并在不同 racks 之间切换，从而优化开发环境的管理。
View on GitHub
Overview
基本能力
产品定位
mcprax 是一个专门用于管理 Model Context Protocol (MCP) 服务器的工具，旨在简化开发者在 Claude Desktop 中配置和管理多个 MCP 服务器的流程。
核心功能
- 定义多个 MCP 服务器配置：支持创建和管理多个 MCP 服务器配置。
- 分组管理：将服务器配置分组到“racks”中，便于管理和切换。
- 配置应用：将 racks 配置应用到 Claude Desktop。
- 版本管理：支持检查和更新 mcprax 工具本身。
适用场景
- 多环境开发：为不同的开发任务（如编码、数据分析、内容创作）配置不同的 racks。
- 工具集成：集成多种工具和服务（如 GitHub、PostgreSQL、文件系统访问）到 Claude Desktop。
- 团队协作：共享和统一团队开发环境配置。
工具列表
- Rack Management：管理 racks 的创建、切换、列表和删除。
- Server Management：管理 MCP 服务器的创建、列表、显示和删除。
- Rack-Server Operations：将服务器挂载或卸载到 racks 中。
- Configuration Application：将 racks 配置应用到 Claude Desktop。
- Application Management：重启 Claude Desktop。
- Version Management：检查和更新 mcprax 工具。
常见问题解答
- “No active rack set”：运行
rax use <rackname>设置 active rack。 - “Server not found”：使用
rax server list检查服务器是否存在。 - 配置未生效：使用
rax reboot重启 Claude Desktop。 - 权限问题：确保对 Claude Desktop 配置目录有写权限。
- 更新失败：可能需要管理员权限，手动运行
npm install -g @ownlytics/mcprax。
使用教程
使用依赖
安装 Node.js 和 npm。
安装教程
通过 npm 全局安装 mcprax：
npm install -g @ownlytics/mcprax
调试方式
- 创建并激活 rack：
rax create ai-tools-rack
rax use ai-tools-rack
- 创建并挂载服务器：
rax server create filesystem '{"command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Documents"]}'
rax mount filesystem
- 应用配置并重启：
rax apply --restart
- 验证配置：
rax mounted