MCP Environment & Installation Manager

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 文件基于 .env.example 模板：

# Copy the example configuration
cp .env.example .env

# Edit the configuration
nano .env

重要环境变量

• MCP_ENV_ENCRYPTION_KEY：加密敏感值时需要
• MCP_ENV_STORAGE_DIR：用于存储配置的目录（默认：~/.mcp环境管理器）

用法

命令行接口

# 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桌面版

1. 运行提供的安装脚本：

npm run setup:claude

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

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

1. 重新启动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。需要进一步的工作，使其完全适用于网络集成。
• 测试MCP服务器通过JSON-RPC在stdio上进行通信，这使得自动化测试变得更加复杂。看 testing_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 应保持安全，不应致力于版本控制
• 使用提供的加密密钥对敏感值进行静态加密
• 在生产环境中使用强随机生成的加密密钥

贡献

欢迎投稿！请看 贡献.md 了解详情。

许可证

麻省理工学院