MCP 관리자

AI 모델과 도구 간의 통신을 지원하는 유연한 모델 컨텍스트 프로토콜(MCP) 관리자 서버입니다. Claude, MCP Dockmaster 및 기타 MCP 클라이언트와 호환됩니다.

특징

• MCP 서버 관리 : 여러 MCP 서버를 실행하고 단일 인터페이스에서 관리합니다.

• 작업자 모드 : 다른 MCP 클라이언트의 작업자로 작동

• 자동 검색 : GitHub 및 Smithery 패키지에서 MCP 서버를 자동으로 찾습니다.

• 도구 레지스트리 : MCP 도구 레지스트리에서 도구를 검색하고 설치합니다.

• WebSocket 통신 : 실시간 통신을 위한 WebSocket을 통한 JSON-RPC

• 헤드리스 모드 : API 우선 작업을 위해 헤드리스 모드로 실행

Related MCP server: Scenario Word

시작하기

필수 조건

• Node.js(v18+)

• NPM(v8+)

설치

지엑스피1

서버 실행

# Run in development mode
npm run dev

# Build and run in production mode
npm run build
npm run start

구성 옵션

.env 파일을 편집하여 MCP 관리자를 구성하세요.

# Server Configuration
PORT=5000                  # Main server port
HOST=0.0.0.0               # Host to bind to
NODE_ENV=development       # Environment (development/production)
REUSE_PORT=true            # Whether to reuse the port

# MCP Port Range
MCP_PORT_RANGE_START=50050 # Start port for MCP servers
MCP_PORT_RANGE_END=50150   # End port for MCP servers

# MCP Compatibility Settings
MCP_WORKER_MODE=false      # Enable worker mode
MCP_DISCOVERY_ENABLED=true # Enable auto-discovery of MCP servers
MCP_AUTOSTART_SERVERS=true # Automatically start MCP servers

# Smithery API Configuration
SMITHERY_API_KEY=your_smithery_api_key_here # API key for Smithery packages

Claude 및 기타 MCP 클라이언트와 함께 MCP Manager 사용

MCP Manager는 다음을 포함한 다양한 MCP 클라이언트와 호환되도록 설계되었습니다.

• 클로드 데스크탑

• MCP 도크마스터

• 툴베이스

• 다른 MCP 호환 클라이언트

Claude Desktop에 연결

1. 로컬 컴퓨터에서 MCP Manager를 실행하세요

2. 클로드 데스크톱 열기

3. 설정 > 고급 > MCP 구성으로 이동하세요.

4. MCP 서버 URL을 http://localhost:5000/ws 로 설정합니다.

5. MCP Manager는 Claude에서 사용 가능한 서버로 나타납니다.

MCP Dockmaster에 연결

1. 로컬 컴퓨터에서 MCP Manager를 실행하세요

2. MCP Dockmaster 열기

3. "서버 추가"를 클릭하세요

4. 서버 정보를 입력하세요:

   • 이름: MCP 관리자

   • 주소: localhost

   • 포트: 5000

5. "연결"을 클릭하세요

작업자 모드 사용

MCP Manager는 다른 MCP 클라이언트의 작업자로 작동할 수 있습니다.

1. .env 파일에서 MCP_WORKER_MODE=true 설정하세요.

2. MCP 관리자 실행

3. MCP 클라이언트에서 MCP 관리자에 연결하세요

4. MCP 관리자는 사용 가능한 도구를 자동으로 검색하고 등록합니다.

헤드리스/API 우선 작업

MCP Manager는 API 우선 클라이언트에 대한 헤드리스 작업을 지원합니다.

GET /?api_key=YOUR_API_KEY&headless=true&auto_connect=true

쿼리 매개변수:

• api_key : API 키(필요한 경우)

• headless : 헤드리스 모드 활성화

• auto_connect : 사용 가능한 MCP 서버에 자동으로 연결합니다.

• ws_url : 사용자 정의 WebSocket URL을 지정합니다.

• server_id : 특정 서버 ID에 연결

API 참조

MCP Manager는 WebSocket을 통해 JSON-RPC 프로토콜을 구현합니다. 주요 API 엔드포인트는 다음과 같습니다.

ws://localhost:5000/ws

사용 가능한 방법

• ping : 서버 연결 테스트

• getServers : 등록된 모든 서버를 가져옵니다

• getServer : ID로 서버 가져오기

• toggleWorker : 서버의 작업자 상태 전환

• getTools : 모든 도구 가져오기

• getToolsByServer : 특정 서버에 대한 도구 가져오기

• activateTool : 도구 활성화

• deactivateTool : 도구 비활성화

• getStats : 서버 통계 가져오기

특허

MIT