Gerente de Instalación y Medio Ambiente de MCP
Un centro de control unificado para la gestión de servidores MCP y sus configuraciones. Este servidor MCP proporciona herramientas para la gestión de variables de entorno, configuraciones basadas en perfiles y la automatización de la instalación local de paquetes.
Características
- Gestión de variables de entorno : almacene y administre de forma segura las variables de entorno para sus servidores MCP
- Sistema de perfiles : crea diferentes perfiles para diferentes proyectos o entornos
- Instalación de paquetes locales : instala automáticamente paquetes MCP localmente
- Vigilancia de la configuración : supervise las configuraciones de MCP y adáptese a los cambios
- Configuración automática : actualiza automáticamente las configuraciones para usar paquetes instalados localmente
Instalación
Instalación de 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
Instalación de 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
Configuración
Cree un archivo .env basado en la plantilla .env.example :
# Copy the example configuration
cp .env.example .env
# Edit the configuration
nano .env
Variables de entorno importantes
MCP_ENV_ENCRYPTION_KEY : Necesario para cifrar valores confidencialesMCP_ENV_STORAGE_DIR : Directorio para almacenar la configuración (predeterminado: ~/.mcp-env-manager)
Uso
Interfaz de línea de comandos
# 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
Con Claude para escritorio
- Ejecute el script de configuración proporcionado:
O agregue manualmente el Administrador de entorno a su archivo de configuración de Claude for Desktop:
{
"mcpServers": {
"env-manager": {
"command": "mcp-env-manager",
"displayName": "Environment & Installation Manager"
}
}
}
- Reinicie Claude for Desktop y comience a utilizar las herramientas del Administrador de entorno.
Con el cursor
Agregue el Administrador de entorno a su archivo de configuración de Cursor MCP:
{
"mcpServers": {
"env-manager": {
"command": "mcp-env-manager"
}
}
}
Ejemplos de herramientas
Gestión de perfiles de entorno
> create-profile
name: "Development Environment"
description: "Configuration for local development"
> list-profiles
Gestión de variables de entorno
> 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"
Administración de instalaciones de MCP
> install-mcp
packageName: "@modelcontextprotocol/server-filesystem"
> list-installed-mcps
> update-mcp
packageName: "@modelcontextprotocol/server-filesystem"
Observación de la configuración
> configure-watcher
watchClaude: true
watchCursor: true
> enable-auto-localize
enabled: true
Desarrollo
# Install dependencies
npm install
# Start in development mode
npm run dev
# Run tests
npm test
# Build the package
npm run build
Limitaciones conocidas y mejoras futuras
- Transporte SSE : La implementación actual del transporte SSE está incompleta y recurre a stdio. Se requiere más trabajo para que sea completamente funcional para integraciones web.
- Pruebas : El servidor MCP se comunica mediante JSON-RPC a través de stdio, lo que complica las pruebas automatizadas. Consulte testing_guide.md para conocer los procedimientos de prueba manuales.
- Instalación del paquete : la instalación del paquete depende del entorno local Node.js y debe probarse con paquetes MCP reales.
Ejecución de pruebas manuales
Para obtener detalles sobre las pruebas manuales, consulte la Guía de pruebas .
Implementación de Docker
El paquete incluye un Dockerfile de varias etapas y docker-compose.yml para una fácil implementación:
# Start the service with Docker Compose
docker-compose up -d
# View logs
docker-compose logs -f
# Stop the service
docker-compose down
Consideraciones de seguridad
- La
MCP_ENV_ENCRYPTION_KEY debe mantenerse segura y no comprometerse con el control de versiones. - Los valores sensibles se cifran en reposo utilizando la clave de cifrado proporcionada
- Utilice una clave de cifrado segura generada aleatoriamente para entornos de producción
Contribuyendo
¡Agradecemos sus contribuciones! Para más detalles, consulte CONTRIBUTING.md .
Licencia
Instituto Tecnológico de Massachusetts (MIT)