a2asearch-mcp

A2ASearch MCP

アシスタントがツールを見つけ、調査し、セットアップ方法を理解できるようにします。

MCP クライアントまたはターミナルから A2ASearch directory を検索して、MCP サーバー、A2A エージェント、コーディングエージェント、CLI ツール、エージェントスキルを探せます。A2ASearch の検索は無料で、API キーは不要です。個々のサービスでは、認証情報や支払いが必要な場合があります。

便利なワークフローを試す

アシスタントに次のように尋ねてください。

PDF から表を抽出する MCP サーバーを見つけてください。ドキュメントに記載された要件を比較し、そのうち 1 つのセットアップ手順を見せてください。料金や認証の情報が不明な場合は、その旨を教えてください。

アシスタントは次の手順で進められます。

search_agents({"query":"PDF","type":"MCP Server","limit":3})
    → names, capabilities, source links and slugs
get_agent({"slug":"<slug returned by search>"})
    → description, README, documentation and repository links
get_setup({"slug":"<same returned slug>"})
    → setup excerpts, quoted JSON examples and next steps

たとえば、Doc2X MCP listing から、セットアップ手順と DOC2X_API_KEY プレースホルダーを含む設定例が記載されたリポジトリにリンクされています。get_setup はその手順を参考資料として取得しますが、認証情報の作成、パッケージのインストール、実行は行いません。

インストール

Node.js 22 以降が必要です。CI では Node.js 22 と 24 をテストしています。

Claude Desktop の場合は、claude_desktop_config.json に次のエントリを追加してください。Cursor の場合は、.cursor/mcp.json を使用してください。既存の設定に統合してください。

{
  "mcpServers": {
    "a2asearch": {
      "command": "npx",
      "args": ["-y", "a2asearch-mcp"]
    }
  }
}

ローカルの stdio MCP サーバーに対応する他のクライアントでは、npx コマンドを引数 -y a2asearch-mcp とともに起動できます。設定形式については、お使いのクライアントのドキュメントを参照してください。

再現性のあるインストールを行うには、リリース後に [email protected] のように、引数でパッケージのバージョンを固定してください。公開前にこのチェックアウトをテストするには、npm ci を実行し、コマンド node にこのリポジトリの index.js への絶対パスを指定するよう設定してください。

ツール

ツール	用途	引数
search_agents	機能や製品を検索する	query、任意の type、limit、page
get_agent	リスト項目とその README を調べる	検索または一覧表示で返された slug
get_setup	セットアップ手順と設定例を絞り込んで読む	検索または一覧表示で返された slug
list_agents	スター数または新着順で一覧を表示する	任意の type、sort、limit、page

limit は 1～20（デフォルトは 10）、page は 1 から始まり、sort は stars または new です。検索はキーワードベースです。PDF、browser automation、database のような簡潔な語を試してください。セマンティック検索や、料金・認証による絞り込みには対応していません。

成功したツール呼び出しは、宣言された出力スキーマを持つ structuredContent と、旧バージョンのクライアント向けに同じデータをテキスト形式でシリアライズしたものの両方を返します。検索結果と一覧表示の結果には、次の情報が含まれます。

• 後続の呼び出しに使う slug と、A2ASearch のリスト項目 URL。
• 提出先、リポジトリ、ドキュメント、ウェブサイトへの個別リンク（利用可能な場合）。
• 提供されている機能、言語、GitHub のスター数、最終コミット日。
• クライアントが推測せずに続きを取得できる、next_page を含むページネーション情報。

値が存在しない場合は null です。現在の API は、料金、認証、ホスティング、日付付きのプロトコルテストの証拠を構造化して提供しません。directory_reviewed が記録するのは、ディレクトリによる承認のみです。GitHub のスター数やコミット日は、実行時の信頼性やセキュリティを示すものではありません。

セットアップ情報

get_setup は、リスティングのディレクトリが提供する README を読み取り、次の情報を返します。

• 対応するセットアップ見出しまたは JSON 設定例が見つかった場合は instructions_found。
• 対応する抜粋がない場合は links_only。プロバイダーへのリンクと役立つ次の手順も返します。
• ソースへのリンク、範囲を限定した抜粋、明示的な制限事項。

設定例はリポジトリ名から生成されるのではなく、そのままコピーされます。GitHub リポジトリの URL はリポジトリとして識別されます。末尾が /mcp または /sse の URL はエンドポイント候補にすぎません。このツールはその URL に接続しておらず、トランスポートや認証方式も確認していません。

説明、README、例は信頼できないソース資料として扱ってください。コマンドや認証情報は使用前に確認してください。この MCP は A2ASearch API の読み取りのみを行います。送信されたコードを実行したり、掲載されているプロバイダーに接続したり、ツールをインストールしたり、クライアント設定を編集したりすることはありません。

ターミナルでの使用方法

# Find tools without installing globally
npx -y -p a2asearch-mcp a2asearch --type mcp PDF

# Use the returned slug for setup guidance (v1.2.0+)
npx -y -p a2asearch-mcp a2asearch --setup doc2x-mcp

# Or install the CLI
npm install -g a2asearch-mcp

a2asearch "browser automation"
a2asearch --type mcp database --page 2
a2asearch --type agent --top
a2asearch --new --limit 5
a2asearch --get doc2x-mcp
a2asearch --setup doc2x-mcp --json

--json は、検索／一覧／詳細コマンドで既存の未加工のディレクトリ API 出力を保持します。新しい --setup --json コマンドは、MCP ツールと同じセットアップオブジェクトを返します。検索結果には、利用可能な場合、後続のコマンドと次のページが表示されます。

ディレクトリの種類	CLI エイリアス
MCP サーバー	mcp
CLI ツール	cli
AI コーディングエージェント	agent
エージェントスキル	skill
A2A エージェント	a2a
AI ツール	tool

トラブルシューティング

• 一致する項目がない場合： キーワードを減らすか、カテゴリフィルターを外してください。
• リスティングが見つからない場合： GitHub リポジトリ名から推測せず、返されたスラッグをコピーしてください。
• セットアップの抜粋がない場合： 返されたドキュメントまたはリポジトリのリンクを開いてください。README で未対応の見出しが使われているか、README を利用できない可能性があります。
• HTTP 429： API から報告された再試行間隔が示されている場合は、その時間だけ待ってください。
• タイムアウト： リクエストは 15 秒後に停止し、クライアントによるキャンセルに従います。後でもう一度お試しください。

API とコントリビューション

この MCP は、公開されている A2ASearch REST API をラップします。リスティングの送信、問題の報告、またはセットアップの抽出とクライアント例の改善にご協力ください。パーサーを変更する場合は、公開されているソースと期待する結果を含めてください。

開発

npm ci --ignore-scripts
npm run check
npm test
npm pack --dry-run

# Optional: read-only smoke test against the live directory
npm run smoke:live

テストでは、MCP の stdio ハンドシェイク、出力スキーマ、検索 → 詳細 → セットアップ、ページネーション、URL の分類、セットアップの抽出、情報の欠落、引数の検証、API エラー、キャンセル、両方の CLI エントリーポイントを検証します。通常のテストではフィクスチャを使用し、プロバイダーには接続しません。

MIT ライセンスです。LICENSE を参照してください。