MCP-Hub-MCP 서버

다른 MCP(Model Context Protocol) 서버에 연결하고 관리하는 허브 서버입니다.

개요

이 프로젝트는 다른 MCP 서버에 연결하여 해당 서버의 도구를 나열하고 실행할 수 있는 MCP 허브 서버를 구축합니다. 특히 Cursor의 40개 도구 제한을 우회하는 데 유용합니다. Cursor 외부에서도 자주 사용되지 않는 도구를 숨겨 AI의 실수를 줄이는 데 도움이 됩니다.

Related MCP server: Cursor MCP Installer

주요 특징

• 구성 파일을 통한 다른 MCP 서버에 대한 자동 연결

• 연결된 서버에서 사용 가능한 도구 나열

• 연결된 서버에서 도구를 호출하고 결과를 반환합니다.

구성

mcp.json 에 다음을 추가하세요:

npx 사용하기

지엑스피1

Node 사용(예: 로컬 개발 또는 직접 실행)

npx 로컬 변경 사항을 적용하지 못하거나 빌드된 서버를 직접 실행하려는 경우 다음과 같이 구성할 수 있습니다.

{
  "mcpServers": {
    "mcp-hub": {
      "command": "node",
      "args": [
        "/path/to/your/mcp-hub-mcp/dist/index.js",
        "--config-path",
        "/path/to/your/mcp-hub-config.json"
      ]
    }
  }
}

참고: dist/index.js 존재하도록 프로젝트를 빌드했는지 확인하세요(예: npm run build 또는 pnpm build ).

시스템 프롬프트(또는 커서 규칙)

Before processing a user's request, you must use the "list_all_tools" command to identify which tools are available.

이를 통해 AI 비서가 도구를 사용하기 전에 항상 사용 가능한 도구를 확인하게 됩니다.

설치 및 실행

요구 사항

• Node.js 18.0.0 이상

• npm, yarn 또는 pnpm

설치

# Clone repository
git clone <repository-url>
cd mcp-hub-mcp

# Install dependencies
npm install
# or
yarn install
# or
pnpm install

짓다

npm run build
# or
yarn build
# or
pnpm build

달리다

npm start
# or
yarn start
# or
pnpm start

개발 모드

npm run dev
# or
yarn dev
# or
pnpm dev

구성 파일

MCP-Hub-MCP 서버는 Claude Desktop 형식의 구성 파일을 사용하여 다른 MCP 서버에 자동으로 연결합니다. 다음과 같은 방법으로 구성 파일을 지정할 수 있습니다.

1. 환경 변수: MCP_CONFIG_PATH 환경 변수를 구성 파일 경로로 설정합니다.

2. 명령줄 인수: --config-path 옵션을 사용하여 구성 파일 경로를 지정합니다.

3. 기본 경로: 현재 디렉토리의 mcp-config.json 파일을 사용합니다.

구성 파일 형식:

{
  "mcpServers": {
    "serverName1": {
      "command": "command",
      "args": ["arg1", "arg2", ...],
      "env": { "ENV_VAR1": "value1", ... }
    },
    "serverName2": {
      "command": "anotherCommand",
      "args": ["arg1", "arg2", ...]
    }
  }
}

예:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    },
    "other-server": {
      "command": "node",
      "args": ["path/to/other-mcp-server.js"]
    }
  }
}

용법

MCP-Hub-MCP 서버는 다음과 같은 도구를 제공합니다.

1. list-all-tools

연결된 모든 서버에서 도구 목록을 반환합니다.

{
  "name": "list-all-tools",
  "arguments": {}
}

2. call-tool

특정 서버에서 도구를 호출합니다.

• serverName : 도구를 호출할 MCP 서버의 이름

• toolName : 호출할 도구의 이름

• toolArgs : 도구에 전달할 인수

{
  "name": "call-tool",
  "arguments": {
    "serverName": "filesystem",
    "toolName": "readFile",
    "toolArgs": {
      "path": "/Users/username/Desktop/example.txt"
    }
  }
}

커밋 메시지 규칙

이 프로젝트는 자동 버전 관리 및 CHANGELOG 생성을 위해 기존 커밋을 따릅니다.

형식: <type>(<scope>): <description>

예:

• feat: add new hub connection feature

• fix: resolve issue with server timeout

• docs: update API documentation

• chore: update dependencies

유형:

• feat : 새로운 기능(MINOR 버전 범프)

• fix : 버그 수정(패치 버전 범프)

• docs : 문서만 변경됨

• style : 코드의 의미에 영향을 미치지 않는 변경 사항

• refactor : 버그를 수정하지도 않고 기능을 추가하지도 않는 코드 변경

• perf : 성능을 향상시키는 코드 변경

• test : 누락된 테스트 추가 또는 기존 테스트 수정

• chore : 빌드 프로세스 또는 보조 도구의 변경

주요 변경 사항: 커밋 바닥글에 BREAKING CHANGE: 추가하여 주요 버전을 올립니다.

기술 스택

• 노드.js

• 타입스크립트

• @modelcontextprotocol/sdk (버전: ^1.9.0)

• zod(버전: ^3.22.4)

특허

MIT