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
용법
필수 조건
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에 게시할 수도 있습니다.