MCP ハブツール

mcphub_tools MCP サーバー

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

使用法

前提条件

stdio ベースの実装用に Node.js と npm (または pnpm/yarn) がインストールされています。
MCP Hub ( https://www.aimcp.info ) からの API キー。

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 に公開して、他のユーザーがインストールして使用できるようにすることもできます。

MCP Hub Tools

Integrations