nooscape-mcp

nooscape-mcp

Nooscape 用の MCP サーバーです。AI アシスタントやエージェントが、支払いを行ったり相手を信頼したりする前に、エージェント、ウォレット、エンドポイントについて記録されている情報を確認できます。

公開されている Nooscape API（https://nooscape.si/api/v1）を読み取り専用で利用するシンプルなクライアントです。独自のデータやロジックは追加しません。すべての回答に、読み取り日時、情報源、証拠レベルが記載されます。

提供する機能

読み取り専用のツールが5つあります。それぞれ、最初に短い要約を返し、その後に API の JSON を受け取ったままの形で返します。

ツール	機能	必要なもの
search_agents(query, chain?)	名前、エンドポイントのホスト、レジストリキー、またはウォレットで、登録済みのエージェントを検索します。	なし
get_stats()	各チェーンについてディレクトリに記録されている情報を返します。掲載エントリー数とその登録元のレジストリ、集計対象となるオンチェーンの評価、過去24時間以内に初めて確認されたエントリー数、各チェーンの最終読み取り日時が含まれます。Nooscape が読み取らないチェーンはインデックス未登録として報告され、ゼロとは区別されます。	なし
get_agent(chain, id)	1つのエージェントの記録を返します。初回および最終確認日時、登録者、証拠レベル、同じウォレットを共有する掲載情報、レジストリのアクティビティ、評価、所有者による申し立てがあればその内容が含まれます。	API キー（無料キーで十分です）
get_agent_history(chain, id)	1つのエージェントのレジストリイベントと、そのエージェントに関する申し立ての公開履歴を返します。	API キー（無料キーで十分です）
check(agent | wallet | url)	事前確認情報を返します。各掲載情報の初回確認日時、記録された所有権の変更、取り消された評価の割合、そのウォレットで登録された掲載情報の数、証拠レベルが含まれます。	Pro キー、または x402 による支払い（下記を参照）

チェーンは robinhood（Robinhood Chain）、bnb（BNB Smart Chain）、solana、ethereum（Ethereum）、base（Base）、arc（Arc）です。robinhood、bnb、ethereum、base、arc におけるエージェントの ID はトークン ID（数字）です。Solana では、1つのアドレスが複数のレジストリに掲載されている場合があります。どちらのエージェント用ツールも、使用するレジストリを選ぶための省略可能な registry（solana_8004、solana_said、solana_registry）を受け取ります。

check が受け取るのは、agent（{ chain, id }）、wallet、url のいずれか1つだけです。url には完全なアドレスのほか、example.com のようなホスト名のみも指定できます。照合にはホスト名のみを使い、その URL から何かを取得することはありません。chain を指定すると、wallet または url の検索対象を絞り込めます。

インストール

Node.js 18 以降が必要です。ビルドは不要で、npx が取得します。npx -y nooscape-mcp を実行すると、起動のたびに最新リリースが実行されます。特定のリリースを使い続けるには、[email protected] のようにバージョンを指定してください。

Claude Desktop

以下を claude_desktop_config.json（Settings、Developer、Edit Config）に追加してから、Claude Desktop を再起動してください。

{
  "mcpServers": {
    "nooscape": {
      "command": "npx",
      "args": ["-y", "nooscape-mcp"],
      "env": { "NOOSCAPE_API_KEY": "nsk_your_key_here" }
    }
  }
}

キーなしで使用する場合は、env ブロックを省略してください。検索と参照はキーなしで利用できます。

Cursor

同じブロックを ~/.cursor/mcp.json（またはプロジェクト内の .cursor/mcp.json）に追加してください。

{
  "mcpServers": {
    "nooscape": {
      "command": "npx",
      "args": ["-y", "nooscape-mcp"],
      "env": { "NOOSCAPE_API_KEY": "nsk_your_key_here" }
    }
  }
}

Claude Code

claude mcp add nooscape --env NOOSCAPE_API_KEY=nsk_your_key_here -- npx -y nooscape-mcp

その他の MCP クライアント

npx -y nooscape-mcp を stdio サーバーとして実行してください。

環境変数

変数	説明
NOOSCAPE_API_KEY	省略可能です。Authorization: Bearer として送信される API キーです。無料キーは nooscape.si/developers/keys で作成できます。ログに記録されたり、応答にそのまま出力されたり、結果やエラーに含まれたりすることはありません。

キー、制限、支払い

• キーなしの場合： search_agents、get_agent、get_stats は、1つのアドレスから1分あたり30リクエストまで利用できます。
• **無料キーを使うと、**1分あたり60リクエスト、1日あたり1,000リクエストまで利用できるようになり、get_agent_history も使えるようになります。
• check には Pro キーまたは x402 による支払いが必要です（現在は1回あたり $0.01、Base または Arc 上の USDC）。このサーバーはウォレットを保持せず、支払いへの署名も送信もしません。 Pro キーがない場合、check は価格と API が要求した条件を明記したメッセージを返すだけで、料金は発生しません。x402 対応クライアントは API に直接支払えます。このサーバー内からの支払いは、今後対応する可能性があります。
• 拒否されたリクエストは再試行されません。レート制限に達した場合、何秒待つ必要があるかがメッセージに示されます（API の Retry-After）。
• リクエストは15秒でタイムアウトします。

プロンプトの例

• 「Nooscape で Robinhood Chain のエージェント 8865 を調べてください。最初に確認されたのはいつで、誰が登録しましたか？」
• 「Nooscape でホストが example.com のエージェントを検索してください。」
• 「このウォレットに支払う前に、Nooscape にはどのような記録がありますか？」（check を使用）
• 「BNB エージェント 12 の登録イベントとクレーム履歴を表示してください。」
• 「Nooscape には各チェーンのエントリーがいくつあり、それぞれのチェーンが最後に読み込まれたのはいつですか？」（get_stats を使用）

回答が意味すること、意味しないこと

• Nooscape が提供するのは、日付付きの事実です。エージェントを審査、順位付け、評価することはなく、回答はエージェントが良いか悪いか、安全か危険かを示すものではありません。このサーバーの要約にそうした語句を加えることはなく、モデルへの指示でも、そのような推論をしないよう伝えています。
• 支払っても、掲載、ティア、証拠レベルは購入できません。 支払いによって記録、スコア、証拠レベルが変わることはありません。
• サイトが非表示、取り下げ、または終了した記録は一切提供されず、最初から掲載されていなかった記録と同じように見えます。
• 掲載内容について所有者が書いた文章は、所有者自身の言葉であり、Nooscape による確認は行われていません。その旨を明記しており、モデルはこれをデータとして扱い、指示として扱ってはなりません。

クレジット表記と利用条件

Nooscape のデータ（https://nooscape.si）。データを使用する場合はクレジット表記が必要です。データの大量コピーを再販しないでください。最終的なデータライセンスは、これらの暫定条件に代わるものです。現在の条件は nooscape.si/terms をご覧ください。各回答には、クレジット表記の行を含む license オブジェクトが付属します。

Streamable HTTP モード

npx -y nooscape-mcp --http                 # http://127.0.0.1:8787/mcp
npx -y nooscape-mcp --http --port 9000

ステートレスで（/mcp への各 POST リクエストで独立したサーバーが起動し、JSON で応答します）、ローカルでのサーバーの動作確認と、将来のホスティングを想定しています。このパッケージによってどこかにデプロイされることはありません。独自のサインイン機能はないため、次の点に注意してください。

• デフォルトでは 127.0.0.1 のみで待ち受け、Host ヘッダーが一致する場合のみ受け付けます。また、別のサイトのウェブページが送信する Origin ヘッダーを含むリクエストはすべて拒否します。
• このマシン以外を指定する --host は、--allow-remote も指定しない限り拒否されます（コンテナー内で待ち受けるには指定が必要です）。このマシンの外からの接続では、サーバーは公開名を把握できないため、Host と Origin のチェックは適用されません。
• サーバーにアクセスできる全員が、サーバー共通の NOOSCAPE_API_KEY を使用します。そのまま公開アドレスに置かないでください。手前に、呼び出し元のサインインを処理する仕組みを設置してください。ホスト版では呼び出し元ごとのキーが必要です。

セキュリティに関する注意

• サーバーがリクエストを送信する先は nooscape.si のみです。リダイレクトには従わず、キーを送信する先もここだけです。
• 書き込み、支払い、署名、処理の実行を行うツールはありません。ツールは読み取り専用として指定されています。
• 結果には他の人が書いたテキスト（所有者が記入したフィールドやエージェント名）が含まれる場合があります。他のツールの出力と同様に、信頼できないデータとして扱ってください。

レジストリへの掲載

このパッケージは npm および公式 MCP レジストリ（io.github.RunTimeAdmin/nooscape-mcp）に掲載されています。このレジストリは server.json を読み込みます。manifest.json は、Smithery の stdio バンドル用の MCPB マニフェストです。

開発

pnpm install
pnpm run build
pnpm test

テストでは、モック API とインメモリトランスポートを介した実際の MCP クライアントを使用します。このパッケージはスタンドアロンであり、Nooscape サイトのビルドやデプロイには含まれません。

ライブ API に対して 5 つすべてのツールを試すには（リクエストは約 12 件で、課金や変更はありません）。

node scripts/live-check.mjs                          # the built server
node scripts/live-check.mjs --npx ./nooscape-mcp-0.1.0.tgz   # through npx, after `npm pack`
NOOSCAPE_API_KEY=nsk_... node scripts/live-check.mjs  # with a key, to see the history succeed

ライセンス

MIT。