aimcp を搭載したMCPツールで、お探しのMCPを見つけてください。このサーバーでは、MCPハブで利用可能なMCPを検索できます。
オープンプロトコル
このサーバーはモデルコンテキストプロトコル（MCP）を実装しています。MCPクライアント（互換性のあるAIアシスタントや開発ツールなど）が接続できるMCPサーバーとして機能します。
導入
mcphub_toolsは、 MCP Hubと連携するように設計された MCP サーバーです。主な機能は、ユーザーがキーワードに基づいてハブに登録されている MCP（モデルコンテキストプロトコル/サーバー）を検索できるツールを提供することです。
ツール
このサーバーは次のツールを提供します:
search_mcp_hub
- 説明: MCP ハブで MCP を検索します。
- 入力スキーマ:
{
"type": "object",
"properties": {
"keywords": {
"type": "string",
"description": "Keywords to search for MCPs"
}
},
"required": ["keywords"]
}
- 出力: MCP Hub API からの検索結果を含む JSON 文字列を返します。
get_mcp_info
- **説明:**特定の MCP に関する詳細情報を取得します。
- 入力スキーマ:
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "MCP identifier (UUID)"
}
},
"required": ["id"]
}
- **出力:**指定された MCP に関する詳細情報を含む JSON 文字列を返します。
実装オプション
MCP ハブは、MCP サーバーを実装するための 2 つの異なる方法をサポートしています。
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 Hubは、AIアシスタントやその他のツールがHTTP経由でMCPサーバーに接続できるようにするHTTPベースの実装も提供しています。これは、MCP HubのAPI（ /api/open/v1/streamableに実装されています。
HTTP エンドポイントは次の場所で利用できます。
https://mcp.aimcp.info/api/open/v1/streamable
使用法
前提条件
APIキーを取得する方法
- https://www.aimcp.infoにアクセスしてください。
- サインアップまたはログインしてください。
- プロフィールまたはアカウント設定に移動します。
- API キーを生成または取得するためのオプションを探します。
- または、こちらからAPIキーを生成することもできます。注意：APIキーには、1時間あたり20リクエストのレート制限があります。
認証
MCP APIは有効なAPIキーによる認証が必要です。このキーは以下の方法で提供する必要があります。
- stdio ベースの実装の場合: 環境変数
MCP_HUB_API_KEY 。 - HTTP ベースの実装の場合: Bearer トークンとしての
Authorizationヘッダー。
Authorization: Bearer YOUR_API_KEY
AIアシスタントとMCPクライアントとの統合
クロードデスクトップ構成
Claude Desktop で MCP Hub を使用するには:
- Claude Desktop 構成ファイルを見つけます。
- Windows:
%APPDATA%\claude\config.json - macOS:
~/Library/Application Support/claude/config.jsonまたは~/.config/claude/config.json - Linux:
~/.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 ハブ API エンドポイントと対話します。
- エンドポイント:
GET https://www.aimcp.info/api/open/v1/search - 認証:
MCP_HUB_API_KEYを使用して、 Authorizationヘッダーに Bearer トークンが必要です。 - クエリパラメータ:
keywords (文字列)
HTTPベースのMCP APIの使用
MCP Hubは、モデルコンテキストプロトコルを実装した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 に公開して、他のユーザーがインストールして使用できるようにすることもできます。