AgentShopping Intent Catalog

agentshopping-mcp

MCP 互換のエージェントであればどれでも、AgentShopping の購入意向カタログを利用できるようにする MCP サーバーです。

読み取り専用です。資金を保有せず、注文を行わず、何も書き込みません。日付と出典を明記した事実を返し、把握していないことも明確に示します。

利用方法は 2 つあります

1. リモートエンドポイント（推奨、インストール不要）

https://agentshopping.org/mcp

MCP Streamable HTTP を使用します。MCP クライアントから URL を指定します。

{
  "mcpServers": {
    "agentshopping": {
      "url": "https://agentshopping.org/mcp"
    }
  }
}

このエンドポイントは公式 MCP Registryに登録されています。

項目	値
名前	org.agentshopping/intent-catalog
バージョン	0.1.1
名前空間	agentshopping.org のドメイン逆引き DNS（HTTP 認証）
ステータス	active
公開日時	2026-11-08T13:47:55Z
ソース	https://github.com/wken2238-byte/agentshopping-mcp

ご自身で確認できます。

curl 'https://registry.modelcontextprotocol.io/v0.1/servers?search=agentshopping'

2. ローカル stdio サーバー（お使いのマシンで実行）

node src/index.js

{
  "mcpServers": {
    "agentshopping": {
      "command": "node",
      "args": ["/absolute/path/to/agentshopping-mcp/src/index.js"]
    }
  }
}

まだ npm では公開されていません。 パッケージ名 agentshopping-mcp は予約されていますが、パッケージはまだレジストリに公開されていないため、npm install -g agentshopping-mcp はまだ機能しません。公開されるまでは、上記のとおりチェックアウトから実行してください。

別のカタログを指定する

stdio サーバーは、設定されていれば AGENTSHOPPING_API_BASE を読み取り、設定されていない場合は https://agentshopping.org を使用します。セルフホストまたはミラーされたカタログに対して実行する場合に利用してください。

{
  "mcpServers": {
    "agentshopping": {
      "command": "node",
      "args": ["/path/to/agentshopping-mcp/src/index.js"],
      "env": { "AGENTSHOPPING_API_BASE": "https://your-mirror.example" }
    }
  }
}

ツール

ツール	返される内容
list_intents	供給状況を含む、購入者の取引意向 100 件
get_intent	1 件の意向に必要なコンテキスト、判断要因、正確な供給状況
list_offers	日付付きの検証済み事実と、明示的な未検証フィールドを含む供給カタログ
match_workload	ワークロードに対する、決定論的で説明可能なマッチまたは却下

match_workload はマッチだけでなく、理由付きの却下も返します。順位付けやスコア付けは行わず、「最良」の選択肢を断定することもありません。却下は失敗ではなく、正式な回答です。

誠実な制約

• 100 件中 99 件の意向には、検証済みの供給パートナーがいません。 すべての応答で、そのことを明示します。
• 価格、仕様、ベンダー、提供状況は断定しません。 不明なフィールドは推測せず、unverified_fields に記載します。
• 意向の順序は編集上のものであり、測定された需要ではありません。
• 現時点で供給パートナーは 1 社です。これはマーケットプレイスではなく、プロトコルの骨組みです。
• プロバイダーへの外部リンクを開くには、内容を把握した人間によるクリックが必要です。自動リダイレクトや iframe はありません。
• レジストリへの登録は、誰かが利用していることを意味しません。見つけられる状態になったということです。

リモートエンドポイントを自分で実行する

デプロイ済みのエンドポイントは src/http-server.py です。Python 3 の標準ライブラリのみを使用し、依存関係はありません。

MCP_PORT=8787 MCP_DATA_ROOT=/path/to/site python3 src/http-server.py

設計上の制約は次のとおりです。

• 127.0.0.1 のみにバインドします。TLS リバースプロキシの背後で公開してください。
• 静的な JSON をディスクから読み取ります。外部へのネットワーク呼び出し、ポーリング、バックグラウンド処理はありません。
• リクエスト本文は最大 64 KB です。パストラバーサル対策を施した許可リストを使用します。
• 同時接続数に上限を設けたスレッド処理と接続ごとのタイムアウトにより、応答の遅いクライアントがほかのクライアントをブロックしないようにしています。
• MemoryMax=64M と CPUQuota=10% を設定した systemd のもとで実行します。

src/http-server.cjs は同じサーバーの Node 版で、参考用に保持しています。デプロイ済みのインスタンスは Python 版です。

プロトコルの詳細

• リモート： POST /mcp を使用した MCP Streamable HTTP です。GET は 405 を返します。SSE ストリームを開いたままにはしません。
• ローカル： 標準入力／標準出力を使用する、改行区切りの JSON-RPC（MCP stdio トランスポート）です。ログは標準エラー出力にのみ出力します。Node.js >= 18 が必要です。
• 対応メソッド：initialize、ping、tools/list、tools/call、resources/list（空）、prompts/list（空）。通知は応答を返さずに無視されます。

手動テスト

printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18"}}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' \
  '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_intent","arguments":{"id":"book-flight"}}}' \
  | node src/index.js

レジストリへの変更の公開

npm i -g mcp-publisher
cd agentshopping-mcp
./publish.sh 0.1.1     # bumps the version in server.json, then publishes

publish.sh は HTTP 認証を使用します。ローカルの ECDSA P-384 キーでチャレンジに署名し、レジストリが https://agentshopping.org/.well-known/mcp-registry-auth から公開鍵を取得します。人がクリックする必要はありません。

レジストリ独自の JWT の有効期間はわずか 5 分のため、ログインと公開の手順は間を空けずに連続して実行します。スクリプトはこれに加えて、まれに発生するネットワークの停止に備えた再試行も処理します。

証明ファイルと鍵ペアの生成方法を含む詳しい手順は、发布指引.md（中国語）に記載されています。

ライセンス

MIT — LICENSE を参照してください。