MCP 환경 및 설치 관리자
MCP 서버 및 해당 구성을 관리하는 통합 제어 센터입니다. 이 MCP 서버는 환경 변수 관리, 프로필 기반 구성 및 로컬 패키지 설치 자동화를 위한 도구를 제공합니다.
특징
- 환경 변수 관리 : MCP 서버의 환경 변수를 안전하게 저장하고 관리합니다.
- 프로필 시스템 : 다양한 프로젝트나 환경에 맞게 다양한 프로필을 생성합니다.
- 로컬 패키지 설치 : MCP 패키지를 로컬에 자동으로 설치합니다.
- 구성 감시 : MCP 구성을 모니터링하고 변경 사항에 적응합니다.
- 자동 구성 : 로컬에 설치된 패키지를 사용하도록 구성을 자동으로 업데이트합니다.
설치
Node.js 설치
지엑스피1
도커 설치
# 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를 다시 시작하고 환경 관리자 도구를 사용하세요.
커서 포함
Cursor MCP 구성 파일에 Environment Manager를 추가합니다.
{
"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 서버는 stdio를 통한 JSON-RPC 통신을 통해 통신하므로 자동화 테스트가 더욱 복잡해집니다. 수동 테스트 절차는 testing_guide.md를 참조하세요.
- 패키지 설치 : 패키지 설치는 로컬 Node.js 환경에 따라 달라지며 실제 MCP 패키지로 테스트해야 합니다.
수동 테스트 실행
수동 테스트에 대한 자세한 내용은 테스트 가이드를 참조하세요.
도커 배포
패키지에는 손쉬운 배포를 위한 다단계 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를 참조하세요.
특허
MIT