mcphub

MCPHub: 모델 컨텍스트 프로토콜(MCP) 서버를 위한 통합 허브

영어 |中文版

MCPHub를 사용하면 여러 MCP(Model Context Protocol) 서버를 유연한 Streamable HTTP(SSE) 엔드포인트로 구성하여 쉽게 관리하고 확장할 수 있으며, 모든 서버, 개별 서버 또는 논리적 서버 그룹에 액세스할 수 있습니다.

🚀 특징

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

🔧 빠른 시작

선택적 구성

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

지엑스피1

도커 배포

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

또는 기본 설정으로 실행:

대시보드에 액세스

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

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

대시보드 개요 :

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

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

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

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

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

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

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

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

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

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

서버별 엔드포인트 : 개별 서버에 직접 액세스하려면 서버별 HTTP 엔드포인트를 사용하세요.

여기서 {server} 연결하려는 서버의 이름입니다. 이를 통해 특정 MCP 서버에 직접 액세스할 수 있습니다.

참고 : 서버 이름과 그룹 이름이 같으면 그룹 이름이 우선합니다.

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

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

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

개별 서버에 직접 액세스하려면 서버별 SSE 엔드포인트를 사용하세요.

🧑‍💻 지역 개발

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

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

🛠️ 일반적인 문제

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

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

🔍 기술 스택

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

👥 기여하기

어떤 종류의 기여라도 환영합니다!

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

토론과 지원을 위해 Discord 커뮤니티 에 가입해 주세요.

❤️ 스폰서

이 프로젝트가 마음에 드신다면 다음 프로젝트도 고려해 보세요.

🌟 스타 히스토리

📄 라이센스

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