shumi

@shumi-ai/mcp

Shumi の暗号資産取引インテリジェンスを MCP サーバーとして提供します。shumi CLI が提供するものと同じ市場インテリジェンスを、あらゆる MCP クライアント（Claude Desktop、Claude Code、Cursor、エージェント）で利用できます。

Shumi のデータ API を薄くラップしたものです。価格、トレンド、資金調達率、センチメント、ナラティブ、市場レジーム、統合シグナル、ペア／デルタニュートラルのアイデア、実世界資産、保有者とウォレットの追跡、トランスクリプトのハイライトを提供します。すべてのツールは読み取り専用です。

クイックスタート

Shumi API キー（shumi_sk_…）が必要です。https://shumi.ai で作成してください。

Claude Desktop / Claude Code

MCP 設定に追加します（claude_desktop_config.json、または Claude Code では claude mcp add）。

{
  "mcpServers": {
    "shumi": {
      "command": "npx",
      "args": ["-y", "@shumi-ai/mcp"],
      "env": {
        "SHUMI_TOKEN": "shumi_sk_your_key_here"
      }
    }
  }
}

クライアントを再起動します。shumi ツール（例：get_coin_risk、get_market_health、ask_shumi）が自動的に表示されます。

Cursor

~/.cursor/mcp.json では、上記と同じ command／args／env の形式を使用します。

プラグインディレクトリ

このリポジトリにはルートに plugin.json と mcp.json も含まれているため、Cursor のディレクトリや、この標準に対応する他のクライアントからエージェントプラグインとしてインストールできます。

この方法でインストールする場合は、クライアントを起動する前に環境に SHUMI_TOKEN を設定してください。Agent Plugins のスキーマでは環境変数にリテラル値のみ指定でき、シークレット用のプレースホルダーがありません。そのため、マニフェストでは意図的に env を省略しています。${SHUMI_TOKEN} という文字列をそのまま渡すと、無効なキーとしてエラーになるためです。

ツール

型指定あり（決定的）： get_coin_risk、lookup_coin、resolve_coin、get_coin_sentiment、get_coin_historical、get_market_health、get_market_crossing、get_global_market、get_prices、scan_trends、scan_coins、get_market_sentiment、list_narratives、get_narrative、list_categories、get_category、get_funding_momentum、get_funding_alerts、get_regime、get_signal、get_signal_quality、get_pair_suggestions、list_rwa_assets、get_rwa_asset、get_unlocks、get_unlock_calendar、get_holders、get_wallets、get_futures_signals、get_basket、get_transcripts。

実世界資産（list_rwa_assets、get_rwa_asset）では、Hyperliquid のビルダー DEX 上で永久先物として取引される株式、ETF、コモディティ、指数、FX を扱います。これらは暗号資産トークンではないため、コイン用ツールでは見つかりません。

自由形式： ask_shumi（自然言語での質問に対し、Shumi が分類、取得、統合します）と search_web。

リストを返すツールでは、トークン数を節約するために top（先頭から N 件を保持）と fields（保持するキーをカンマ区切りで指定）を使用できます。

リソース： shumi://capabilities（データの範囲）と shumi://billing/tier（現在の利用権限）。

設定

環境変数	デフォルト	用途
SHUMI_TOKEN	—	API キー（shumi_sk_*）。必須。
SHUMI_API_URL	production coinrotator-ai endpoint	API のベース URL を上書きします。
SHUMI_WALLET	—	NLP クエリのコンテキストに含めるウォレットアドレス。

利用制限（free／access／pro ティアおよび従量課金）は、CLI とまったく同じようにサーバー側で適用されます。クォータを超過した場合は、対処方法を示すヒントを含む構造化エラーが返されます。

リモート（HTTP）

ホスト型のマルチユーザー環境にデプロイする場合：

PORT=8787 SHUMI_MCP_ALLOWED_ORIGINS=https://yourapp.com npm run start:http

各リクエストは個別のキーを含むヘッダーで認証され、そのトークンはリクエストごとに上流 API に転送されます。エンドポイント：POST /mcp、ヘルスチェック：GET /health。

Claude からの接続（static_headers）

Claude はリクエストヘッダーに固定の認証情報を入力できるため、OAuth サーバーは不要です。 Add custom connector → request headers で、組織の管理者が次の値を入力します。

field	value
URL	https://mcp.shumi.ai/mcp
Header name	Authorization
Header value	Bearer shumi_sk_…

x-api-key: shumi_sk_… も使えます。また、Bearer プレフィックスを省略した Authorization の値も使えます。管理者が一度手動で入力するもので、入力を間違えると、確認できるエラーが表示されずに失敗するため、3 種類すべての形式を受け付けます。両方が指定されている場合は、管理者が設定した意図を尊重し、x-api-key が優先されます。

キーを URL に含めないでください。 MCP の認可仕様では URI のクエリ文字列にアクセストークンを含めることが禁止されており、Anthropic も URL に認証情報を含めることをセキュリティ上の脆弱性として説明しています。URL はサーバーログ、プロキシ、ブラウザーの履歴に記録されます。?shumiToken=／?config= 形式のクエリは、Smithery がセッション設定をその方法で挿入するためだけに存在します。

チーム向けに購入する前に知っておくべきことがあります。static_headers の認証情報はユーザーごとではなく、組織で共有されます。このコネクター経由で接続する全員が、1 つの Shumi アカウント、1 つの無料プランの利用枠、1 つのクォータを共有します。ユーザーごとの使用量計測には OAuth が必要です。詳しくは docs/oauth-plan.md を参照してください。

認証なしの呼び出しには、401 ではなく、帯域内の AUTH_REQUIRED エラーを含む 200 が返されます。これは意図的な仕様です。Claude は 401 を OAuth フローの開始として扱いますが、その背後に認可サーバーがないサーバーでは、完了できないハンドシェイクにクライアントを進ませてしまいます。401 を返す経路は存在しますが、SHUMI_MCP_AUTH_SERVER が設定されている場合にのみ有効になります。つまり、接続先となる認可サーバーが用意されたときにだけ動作します。

このサーバーはステートレスです。 1 つのエンドポイントが両方のプロトコルリビジョンに対応します。

• 2026-07-28 — initialize も Mcp-Session-Id もありません。リクエストには、ヘッダー（Mcp-Method と、tools/call の場合は Mcp-Name）にルーティング情報が、params._meta にプロトコルエンベロープが含まれるため、中継処理は本文を解析せずに呼び出しをルーティングし、使用量を計測できます。
• 2025-11-25 以前 — 引き続き対応します。古いクライアントでは initialize のハンドシェイクが維持されますが、各やり取りはセッションではなく、それぞれ独自のインスタンスによって処理されます。

リクエスト後に何も残らないため、GET と DELETE（2025 年のセッション操作）は 405 を返します。また、以前ここで設定できたセッション関連のパラメーターである SHUMI_MCP_SESSION_TTL_MS、SHUMI_MCP_MAX_SESSIONS、SHUMI_MCP_SESSION_SWEEP_MS はなくなりました。どのデプロイ環境からも安全に削除できます。設定されていない場合、これらは何もしません。これらのパラメーターで設定していたアイドルセッションのクリーンアップ処理は、稼働確認プローブによるヒープの増加を防ぐためのものでしたが、セッションを保持しない場合、そのような増加は起こりません。

開発

npm install
npm test                # unit tests (no network)
npm run inspect         # open the MCP Inspector against the stdio server
SHUMI_TOKEN=… npm start # run the stdio server

意図的に公開していない機能

CLI の 2 つのルートには、意図的に MCP ツールを用意していません。

• walkforward — ルート自体は存在しますが、Engine B が停止している間は、3 つのアクションのうち 2 つに処理対象がありません。positions は空で、outcomes には 2026-05-28 の行が 1 件だけあります。公開すると、呼び出し元には理由の説明もなく空の配列が返されてしまいます。エンジン再開時に追加します。
• watch — サーバー送信イベントであり、MCP ツールのセマンティクスには適合しません。

CLI の型付きインターフェースにあるその他の機能には、すべてツールが用意されています。