MCP 环境和安装管理器
用于管理 MCP 服务器及其配置的统一控制中心。此 MCP 服务器提供用于环境变量管理、基于配置文件的配置以及本地软件包安装自动化的工具。
特征
- 环境变量管理:安全地存储和管理 MCP 服务器的环境变量
- 配置文件系统:为不同的项目或环境创建不同的配置文件
- 本地包安装:自动在本地安装 MCP 包
- 配置监视:监视 MCP 配置并适应变化
- 自动配置:自动更新配置以使用本地安装的包
安装
Node.js 安装
# Global installation
npm install -g @devlimelabs/mcp-env-manager
# Or using yarn
yarn global add @devlimelabs/mcp-env-manager
# Or using pnpm
pnpm add -g @devlimelabs/mcp-env-manager
Docker 安装
# Clone the repository
git clone https://github.com/devlimelabs/master-mcps.git
cd master-mcps/packages/mcp-env-manager
# Build and run with Docker
npm run docker:build
npm run docker:run
# Or using Docker Compose
npm run compose:up
配置
根据.env.example
模板创建.env
文件:
# Copy the example configuration
cp .env.example .env
# Edit the configuration
nano .env
重要的环境变量
MCP_ENV_ENCRYPTION_KEY
:加密敏感值时必需MCP_ENV_STORAGE_DIR
:存储配置的目录(默认值:~/.mcp-env-manager)
用法
命令行界面
# Start the MCP server with stdio transport (for Claude, Cursor integration)
mcp-env-manager
# Start with SSE transport (for web integration)
mcp-env-manager --sse --port 3000
使用 Claude 桌面版
- 运行提供的安装脚本:
或者手动将环境管理器添加到您的 Claude for Desktop 配置文件中:
{
"mcpServers": {
"env-manager": {
"command": "mcp-env-manager",
"displayName": "Environment & Installation Manager"
}
}
}
- 重新启动 Claude for Desktop 并开始使用环境管理器工具。
使用光标
将环境管理器添加到您的 Cursor MCP 配置文件中:
{
"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
发展
# Install dependencies
npm install
# Start in development mode
npm run dev
# Run tests
npm test
# Build the package
npm run build
已知限制和未来改进
- SSE 传输:当前的 SSE 传输实现尚不完善,并且会回退到 stdio。需要进一步完善才能使其完全兼容 Web 集成。
- 测试:MCP 服务器通过 stdio 上的 JSON-RPC 进行通信,这使得自动化测试更加复杂。请参阅tests_guide.md了解手动测试步骤。
- 包安装:包安装依赖于本地 Node.js 环境,需要使用实际的 MCP 包进行测试。
运行手动测试
有关手动测试的详细信息,请参阅测试指南。
Docker 部署
该软件包包括一个多阶段 Dockerfile 和 docker-compose.yml,可轻松部署:
# Start the service with Docker Compose
docker-compose up -d
# View logs
docker-compose logs -f
# Stop the service
docker-compose down
安全注意事项
MCP_ENV_ENCRYPTION_KEY
应保持安全,并且不提交到版本控制- 使用提供的加密密钥对敏感值进行静态加密
- 在生产环境中使用强大的、随机生成的加密密钥
贡献
欢迎贡献!详情请参阅CONTRIBUTING.md 。
执照
麻省理工学院