MCP 관리자

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

특징

MCP 서버 관리 : 여러 MCP 서버를 실행하고 단일 인터페이스에서 관리합니다.
작업자 모드 : 다른 MCP 클라이언트의 작업자로 작동
자동 검색 : GitHub 및 Smithery 패키지에서 MCP 서버를 자동으로 찾습니다.
도구 레지스트리 : MCP 도구 레지스트리에서 도구를 검색하고 설치합니다.
WebSocket 통신 : 실시간 통신을 위한 WebSocket을 통한 JSON-RPC
헤드리스 모드 : API 우선 작업을 위해 헤드리스 모드로 실행

시작하기

필수 조건

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에 연결

로컬 컴퓨터에서 MCP Manager를 실행하세요
클로드 데스크톱 열기
설정 > 고급 > MCP 구성으로 이동하세요.
MCP 서버 URL을 http://localhost:5000/ws 로 설정합니다.
MCP Manager는 Claude에서 사용 가능한 서버로 나타납니다.

MCP Dockmaster에 연결

로컬 컴퓨터에서 MCP Manager를 실행하세요
MCP Dockmaster 열기
"서버 추가"를 클릭하세요
서버 정보를 입력하세요:
- 이름: MCP 관리자
- 주소: localhost
- 포트: 5000
"연결"을 클릭하세요

작업자 모드 사용

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

.env 파일에서 MCP_WORKER_MODE=true 설정하세요.
MCP 관리자 실행
MCP 클라이언트에서 MCP 관리자에 연결하세요
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

Integrations