MCP 环境与安装管理器

一个统一的控制中心，用于管理MCP服务器及其配置。此MCP服务器提供了环境变量管理、基于配置文件的设置以及本地包安装自动化的工具。

功能

• 环境变量管理：安全地存储和管理您的MCP服务器的环境变量
• 配置文件系统：为不同的项目或环境创建不同的配置文件
• 本地包安装：自动在本地安装MCP包
• 配置监控：监视MCP配置并适应变更
• 自动配置：自动更新配置以使用本地安装的包

安装

Node.js 安装

bash

全局安装

npm install -g @devlimelabs/mcp-env-manager

或者使用yarn

yarn global add @devlimelabs/mcp-env-manager

或者使用pnpm

pnpm add -g @devlimelabs/mcp-env-manager

Docker 安装

bash

克隆仓库

git clone https://github.com/devlimelabs/master-mcps.git
cd master-mcps/packages/mcp-env-manager

使用Docker构建并运行

npm run docker:build
npm run docker:run

或者使用Docker Compose

npm run compose:up

配置

根据.env.example模板创建一个.env文件：

bash

复制示例配置

cp .env.example .env

编辑配置

nano .env

重要环境变量

• MCP_ENV_ENCRYPTION_KEY：加密敏感值所需
• MCP_ENV_STORAGE_DIR：存储配置的目录（默认：~/.mcp-env-manager）

使用方法

命令行界面

bash

使用stdio传输启动MCP服务器（适用于Claude, Cursor集成）

mcp-env-manager

使用SSE传输启动（适用于Web集成）

mcp-env-manager --sse --port 3000

与桌面版Claude配合使用

1. 运行提供的设置脚本：

bash
npm run setup:claude

或者手动将环境管理器添加到你的Claude for Desktop配置文件中：

json
{
"mcpServers": {
"env-manager": {
"command": "mcp-env-manager",
"displayName": "Environment & Installation Manager"
}
}
}

1. 重启Claude for Desktop并开始使用环境管理器工具。

与Cursor配合使用

将环境管理器添加到你的Cursor MCP配置文件中：

json
{
"mcpServers": {
"env-manager": {
"command": "mcp-env-manager"
}
}
}

工具示例

管理环境配置文件

create-profile
name: "Development Environment"
description: "Configuration for local development"

list-profiles

管理环境变量

set-env-var
profileId: "development-environment-12345"
key: "API_KEY"
value: "your-api-key-here"
sensitive: true

list-env-vars
profileId: "development-environment-12345"

activate-profile
profileId: "development-environment-12345"

管理MCP安装

install-mcp
packageName: "@modelcontextprotocol/server-filesystem"

list-installed-mcps

update-mcp
packageName: "@modelcontextprotocol/server-filesystem"

配置监控

configure-watcher
watchClaude: true
watchCursor: true

enable-auto-localize
enabled: true

开发

bash

安装依赖

npm install

以开发模式启动

npm run dev

运行测试

npm test

构建包

npm run build

已知限制及未来改进

• SSE传输：当前SSE传输实现不完整，默认回退到stdio。需要进一步工作使其完全支持Web集成。
• 测试：MCP服务器通过JSON-RPC over stdio进行通信，这使得自动化测试更加复杂。请参阅testing_guide.md获取手动测试程序。
• 包安装：包安装依赖于本地Node.js环境，并应使用实际的MCP包进行测试。## 手动测试运行

有关手动测试的详细信息，请参阅测试指南。

Docker 部署

该包包含一个多阶段的 Dockerfile 和 docker-compose.yml 文件，以便于部署：

bash

使用 Docker Compose 启动服务

docker-compose up -d

查看日志

docker-compose logs -f

停止服务

docker-compose down

安全注意事项

• MCP_ENV_ENCRYPTION_KEY 应保持安全，并且不应提交到版本控制系统中
• 敏感值在存储时使用提供的加密密钥进行加密
• 在生产环境中使用强随机生成的加密密钥

贡献

欢迎贡献！详情请参见 CONTRIBUTING.md。

许可证

MIT