MCP 허브 도구

mcphub_tools MCP 서버

aimcp 기반 MCP 도구로 원하는 MCP를 찾아보세요. 이 서버를 통해 MCP 허브에서 사용 가능한 MCP를 검색할 수 있습니다.

오픈 프로토콜

이 서버는 모델 컨텍스트 프로토콜(MCP)을 구현합니다. MCP 클라이언트(호환되는 AI 어시스턴트 또는 개발 도구 등)가 연결할 수 있는 MCP 서버 역할을 합니다.

소개

mcphub_tools 는 MCP 허브 와 상호 작용하도록 설계된 MCP 서버입니다. 주요 기능은 사용자가 키워드를 기반으로 허브에 등록된 MCP(모델 컨텍스트 프로토콜/서버)를 검색할 수 있는 도구를 제공하는 것입니다.

도구

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

`search_mcp_hub`

설명: MCP 허브에서 MCP를 검색합니다.
입력 스키마:지엑스피1
출력: MCP Hub API의 검색 결과가 포함된 JSON 문자열을 반환합니다.

`get_mcp_info`

설명: 특정 MCP에 대한 자세한 정보를 가져옵니다.
입력 스키마:
{ "type": "object", "properties": { "id": { "type": "string", "description": "MCP identifier (UUID)" } }, "required": ["id"] }
출력: 지정된 MCP에 대한 자세한 정보가 포함된 JSON 문자열을 반환합니다.

구현 옵션

MCP 허브는 MCP 서버를 구현하는 두 가지 방법을 지원합니다.

1. 표준 stdio 기반 MCP 서버

이는 MCP 서버가 표준 입출력(stdio)을 통해 클라이언트와 통신하는 전통적인 구현 방식입니다. 이 방식은 Claude Desktop과 같은 MCP 클라이언트와 통합 가능한 독립형 명령줄 도구에 적합합니다.

stdio 기반 구현을 사용하는 가장 쉬운 방법은 게시된 패키지를 사용하는 것입니다.

# Using npx (recommended for most users)
npx @aimcp/tools

# Using uvx (faster startup)
uvx @aimcp/tools

2. HTTP 기반 MCP 서버

MCP 허브는 AI 어시스턴트 및 기타 도구가 HTTP를 통해 MCP 서버에 연결할 수 있도록 HTTP 기반 구현도 제공합니다. 이는 MCP 허브 API( /api/open/v1/streamable 에 구현되어 있습니다.

HTTP 엔드포인트는 다음에서 사용할 수 있습니다.

https://mcp.aimcp.info/api/open/v1/streamable

용법

필수 조건

stdio 기반 구현을 위해 Node.js와 npm(또는 pnpm/yarn)이 설치되었습니다.
MCP Hub( https://www.aimcp.info )의 API 키.

API 키를 얻는 방법

https://www.aimcp.info 로 이동하세요.
가입하거나 로그인하세요.
프로필이나 계정 설정으로 이동합니다.
API 키를 생성하거나 검색하는 옵션을 찾으세요.
또는 여기에서 API 키를 생성할 수 있습니다. 참고: API 키는 시간당 최대 20개의 요청으로 제한됩니다.

입증

MCP API를 사용하려면 유효한 API 키를 사용한 인증이 필요합니다. 이 키는 다음을 통해 제공되어야 합니다.

stdio 기반 구현의 경우: 환경 변수 MCP_HUB_API_KEY .
HTTP 기반 구현의 경우: Authorization 헤더를 Bearer 토큰으로 사용합니다.

Authorization: Bearer YOUR_API_KEY

AI Assistants 및 MCP 클라이언트와의 통합

클로드 데스크톱 구성

Claude Desktop과 함께 MCP Hub를 사용하려면:

Claude Desktop 구성 파일을 찾으세요.
- 윈도우: %APPDATA%\claude\config.json
- macOS: ~/Library/Application Support/claude/config.json 또는 ~/.config/claude/config.json
- 리눅스: ~/.config/claude/config.json
다음 구성을 추가합니다.

{
  "mcpServers": {
    "mcp-hub": {
      "command": "npx",
      "args": ["@aimcp/tools"],
      "environment": {
        "MCP_HUB_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

변경 사항을 적용하려면 Claude Desktop을 다시 시작하세요.
대화 중에 "@mcp-hub"를 입력하면 MCP Hub 도구에 액세스할 수 있습니다.

Cline 및 기타 CLI 도구

Cline과 같은 명령줄 기반 도구의 경우:

프로젝트 디렉토리에 servers.json 이라는 이름의 구성 파일을 만듭니다.

{
  "servers": [
    {
      "name": "mcp-hub-tools",
      "command": ["npx", "@aimcp/tools"],
      "environment": {
        "MCP_HUB_API_KEY": "YOUR_API_KEY"
      }
    }
  ]
}

다음 구성을 참조하여 도구를 시작합니다.

cline --mcp-servers-config ./servers.json

원격 MCP 서버를 지원하는 도구의 경우

일부 최신 MCP 클라이언트는 직접 HTTP 연결을 지원합니다. 다음을 사용하여 구성하세요.

{
  "mcpServers": {
    "mcp-hub-http": {
      "url": "https://mcp.aimcp.info/api/open/v1/streamable",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

파일 기반 구성을 사용하는 도구(커서 등)의 경우

구성 파일을 만듭니다.

{
  "mcpServers": {
    "mcp-hub": {
      "command": "npx",
      "args": ["@aimcp/tools"],
      "environment": {
        "MCP_HUB_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

도구 설정에서 이 파일을 참조하거나 적절한 구성 매개변수로 실행하세요.

수동 실행

테스트를 위해 stdio 기반 서버를 수동으로 실행할 수도 있습니다(환경에서 MCP_HUB_API_KEY 설정되어 있는지 확인하세요).

export MCP_HUB_API_KEY="YOUR_API_KEY_HERE"
npx @aimcp/tools

API 인터페이스

이 서버는 다음 MCP Hub API 엔드포인트와 상호 작용합니다.

엔드포인트: GET https://www.aimcp.info/api/open/v1/search
인증: MCP_HUB_API_KEY 사용하여 Authorization 헤더에 Bearer 토큰이 필요합니다.
쿼리 매개변수: keywords (문자열)

HTTP 기반 MCP API 사용

MCP 허브는 모델 컨텍스트 프로토콜(MCP)을 구현하는 HTTP 기반 MCP 서버( /api/open/v1/streamable 를 제공합니다. 이를 통해 AI 어시스턴트와 도구는 MCP를 검색하고 MCP 정보를 직접 가져올 수 있습니다.

연결 단계

먼저, 세션 ID를 얻기 위해 연결을 설정합니다.

GET /api/open/v1/streamable
Authorization: Bearer YOUR_API_KEY

응답:

{
  "success": true,
  "sessionId": "194830ab-eb0b-4d17-a574-af96705276c2",
  "message": "Connection established. Use this sessionId for subsequent calls."
}

세션 ID로 도구를 호출합니다.

POST /api/open/v1/streamable?sessionId=194830ab-eb0b-4d17-a574-af96705276c2
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "jsonrpc": "2.0",
  "method": "callTool",
  "params": {
    "name": "search_mcp_hub",
    "arguments": {
      "keywords": "example"
    }
  },
  "id": "call-1"
}

개발 및 배포

개발

설치 종속성: pnpm install
빌드: pnpm run build ( build/ 에서 TypeScript를 JavaScript로 컴파일)
감시 모드: pnpm run watch (변경 시 자동으로 재컴파일)
Inspector로 테스트: pnpm run inspector (MCP Inspector 도구로 서버 실행)

stdio 기반 MCP 서버 만들기

stdio 기반 MCP 서버를 직접 만들려면 다음 단계를 따르세요.

프로젝트 설정:
mkdir my-mcp-server cd my-mcp-server npm init -y npm install @modelcontextprotocol/sdk
서버 구현을 만듭니다.

// index.ts
import { Server } from '@modelcontextprotocol/sdk/server';
import { 
  CallToolRequestSchema, 
  ListToolsRequestSchema,
  McpError,
  ErrorCode
} from '@modelcontextprotocol/sdk/types';
import { StdioTransport } from '@modelcontextprotocol/sdk/transports/stdio';

// Create an MCP server instance
const server = new Server(
  {
    name: "my-mcp-server",
    version: "1.0.0"
  },
  {
    capabilities: {
      tools: {},
    }
  }
);

// Set up tool handlers
server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: [
    {
      name: 'my_tool',
      description: 'Description of my tool',
      inputSchema: {
        type: 'object',
        properties: {
          param1: {
            type: 'string',
            description: 'Description of param1',
          },
        },
        required: ['param1'],
      },
    },
  ],
}));

server.setRequestHandler(CallToolRequestSchema, async (request) => {
  // Extract tool name and arguments
  const toolName = request.params.name;
  const args = request.params.arguments;
  
  if (toolName === 'my_tool') {
    // Validate arguments
    if (typeof args !== 'object' || args === null || typeof args.param1 !== 'string') {
      throw new McpError(
        ErrorCode.InvalidParams,
        'Invalid arguments. Requires "param1" (string).'
      );
    }
    
    try {
      // Implement your tool logic here
      const result = `Processed: ${args.param1}`;
      
      return {
        content: [
          {
            type: 'text',
            text: result,
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: 'text',
            text: `Error: ${error instanceof Error ? error.message : String(error)}`,
          },
        ],
        isError: true,
      };
    }
  } else {
    throw new McpError(
      ErrorCode.MethodNotFound,
      `Unknown tool: ${toolName}`
    );
  }
});

// Connect the server to stdin/stdout
const transport = new StdioTransport();
server.connect(transport).catch(console.error);

서버를 컴파일하고 실행합니다.
npx tsc node dist/index.js
MCP Inspector 도구로 서버를 테스트하세요.
npx @modelcontextprotocol/inspector

전개

서버가 빌드되었는지 확인하세요( pnpm run build ).
build 디렉토리에는 필요한 JavaScript 파일이 들어 있습니다.
패키지가 적절하게 설치된 경우(예: 전역적으로 또는 링크로 설치된 경우) node build/index.js 또는 mcphub_tools 명령을 사용하여 서버를 실행할 수 있습니다.
MCP 클라이언트/관리자가 서버 실행 파일을 가리키도록 구성하고 MCP_HUB_API_KEY 환경 변수를 제공합니다.

다른 사람들이 설치하고 사용할 수 있도록 MCP 서버를 npm에 게시할 수도 있습니다.

MCP Hub Tools

Integrations