맥퍼브 | Glama

MCPHub: 최고의 MCP 서버 허브

MCPHub는 여러 MCP(모델 컨텍스트 프로토콜) 서버를 그룹별 다양한 시나리오에 맞춰 별도의 Streamable HTTP(SSE) 엔드포인트로 통합하는 통합 관리 플랫폼입니다. 직관적인 인터페이스와 강력한 프로토콜 처리를 통해 AI 도구 통합을 간소화합니다.

🚀 특징

즉시 사용 가능한 MCP 서버 지원 : amap-maps , playwright , fetch , slack 등의 인기 서버를 원활하게 통합합니다.
중앙 집중식 대시보드 : 세련된 웹 UI에서 실시간 상태와 성과 지표를 모니터링합니다.
유연한 프로토콜 처리 : stdio와 SSE MCP 프로토콜 모두와 완벽하게 호환됩니다.
핫스왑 구성 : 가동 중지 시간 없이 MCP 서버를 즉시 추가, 제거 또는 업데이트할 수 있습니다.
그룹 기반 액세스 제어 : 효율적인 권한 관리를 위해 서버를 사용자 정의 가능한 그룹으로 구성합니다.
보안 인증 : JWT와 bcrypt로 구동되는 역할 기반 액세스를 갖춘 내장형 사용자 관리.
Docker 지원 : 컨테이너화된 설정으로 즉시 배포 가능.

🔧 빠른 시작

선택적 구성

mcp_settings.json 파일을 만들어 서버 설정을 사용자 지정하세요.

지엑스피1

참고 : 기본 사용자 인증 정보는 admin / admin123 입니다. 비밀번호는 bcrypt로 안전하게 해시됩니다. 다음을 사용하여 새 해시를 생성하세요.
npx bcryptjs your-password

도커 배포

권장 사항 : 사용자 정의 구성을 마운트하세요.

docker run -p 3000:3000 -v $(pwd)/mcp_settings.json:/app/mcp_settings.json samanhappy/mcphub

또는 기본 설정으로 실행:

docker run -p 3000:3000 samanhappy/mcphub

대시보드에 액세스

http://localhost:3000 열고 자격 증명을 사용하여 로그인하세요.

참고 : 기본 자격 증명은 admin / admin123 입니다.

대시보드 개요 :

모든 MCP 서버의 라이브 상태
서버 활성화/비활성화 또는 재구성
서버 구성을 위한 그룹 관리
접근 제어를 위한 사용자 관리

스트리밍 가능한 HTTP 엔드포인트

현재 스트리밍 HTTP 엔드포인트 지원은 AI 클라이언트마다 다릅니다. 문제가 발생하면 SSE 엔드포인트를 사용하거나 향후 업데이트를 기다리세요.

다음을 통해 AI 클라이언트(예: Claude Desktop, Cursor, DeepChat 등)를 연결합니다.

http://localhost:3000/mcp

이 엔드포인트는 모든 MCP 서버에 통합된 스트리밍 가능 HTTP 인터페이스를 제공합니다. 이를 통해 다음 작업을 수행할 수 있습니다.

구성된 MCP 서버에 요청을 보냅니다.
실시간으로 응답을 받으세요
다양한 AI 클라이언트 및 도구와 쉽게 통합 가능
모든 서버에 동일한 엔드포인트를 사용하여 통합 프로세스를 간소화합니다.

그룹별 엔드포인트(권장) :

특정 서버 그룹에 대한 타겟 액세스를 위해 그룹 기반 HTTP 엔드포인트를 사용하세요.

http://localhost:3000/mcp/{group}

여기서 {group} 은 대시보드에서 만든 그룹의 ID 또는 이름입니다. 이를 통해 다음 작업을 수행할 수 있습니다.

사용 사례별로 구성된 특정 MCP 서버 하위 집합에 연결
다양한 AI 도구를 분리하여 관련 서버에만 액세스합니다.
다양한 환경이나 팀에 대해 보다 세분화된 액세스 제어를 구현합니다.

SSE 엔드포인트(향후 사용 중단 예정)

다음을 통해 AI 클라이언트(예: Claude Desktop, Cursor, DeepChat 등)를 연결합니다.

http://localhost:3000/sse

특정 서버 그룹에 대한 타겟 액세스를 위해 그룹 기반 SSE 엔드포인트를 사용하세요.

http://localhost:3000/sse/{group}

🧑‍💻 지역 개발

git clone https://github.com/samanhappy/mcphub.git
cd mcphub
pnpm install
pnpm dev

이렇게 하면 프런트엔드와 백엔드가 모두 핫 리로딩을 통해 개발 모드로 시작됩니다.

Windows 사용자의 경우 백엔드 서버와 프런트엔드를 별도로 시작해야 할 수도 있습니다: pnpm backend:dev , pnpm frontend:dev .

🛠️ 일반적인 문제

Nginx를 역방향 프록시로 사용하기

Nginx를 사용하여 MCPHub를 역방향 프록시하는 경우 Nginx 설정에 다음 구성을 추가해야 합니다.

proxy_buffering off

🔍 기술 스택

백엔드 : Node.js, Express, TypeScript
프런트엔드 : React, Vite, Tailwind CSS
인증 : JWT 및 bcrypt
프로토콜 : 모델 컨텍스트 프로토콜 SDK

👥 기여하기

기여를 환영합니다!

새로운 기능 및 최적화
문서 개선
버그 보고 및 수정
번역 및 제안

📄 라이센스

Apache 2.0 라이선스 에 따라 라이선스가 부여되었습니다.

mcphub

Integrations