Spirit Cards

spirit-cards-mcp

読み取り専用のModel Context Protocol（MCP）サーバーです。 **Spirit Cards（Proof of Card）**向けのサーバーで、Robinhood Chain上でプルーフ・オブ・ワークによりミントされるコレクションカードゲームです。メインネットの chainId 4663 で、2026-10-05から稼働しています。

stdio経由で動作するため、Claude DesktopとCursorからnpxで起動できます。ホストされたWeb APIからゲームのライブデータを取得し、viemを使ってプルーフ・オブ・ワークをローカルで計算します。そのため、エージェントはウォレット、秘密鍵、トランザクションを一切使わずに、コレクションの確認、nonceの検証、さらには有効なnonceの探索まで行えます。

**読み取り専用です。**鍵、シークレット、署名、送信はありません。すべてのネットワーク呼び出しは通常のGETです。

---

クイックスタート

npxで実行（公開後）

npx spirit-cards-mcp

ソースから実行

npm install
node src/index.mjs      # starts the stdio server (logs to stderr)

サーバーはstdin/stdout経由でMCPを使用し、ログはstderrにのみ出力します。通常は手動ではなく、MCPクライアントによって起動されます。

---

Claude Desktopで使用する

claude_desktop_config.jsonに以下を追加してください （macOSでは~/Library/Application Support/Claude/、Windowsでは%APPDATA%\Claude\）。

{
  "mcpServers": {
    "spirit-cards": {
      "command": "npx",
      "args": ["-y", "spirit-cards-mcp"],
      "env": { "SPIRIT_CARDS_API": "https://spiritcards.fun" }
    }
  }
}

Cursorで使用する

.cursor/mcp.json（プロジェクト）または~/.cursor/mcp.json（グローバル）に以下を追加してください。

{
  "mcpServers": {
    "spirit-cards": {
      "command": "npx",
      "args": ["-y", "spirit-cards-mcp"],
      "env": { "SPIRIT_CARDS_API": "https://spiritcards.fun" }
    }
  }
}

---

設定

環境変数	デフォルト	意味
SPIRIT_CARDS_API	https://spiritcards.fun	ホストされたサイト/APIのベースURL

すべてのデータエンドポイントは読み取り専用のGETです。

• /.well-known/ai.json — プロジェクトの記述子（チェーンID、コアコントラクト、仕組み、リンク）
• /stats/current.json — ライブの供給量、価格、必要な難易度（baseBits）、クールダウン
• /api/meta/{tokenId} — カードのメタデータ
• /api/points — ポイントランキング
• /api/pool — ステーキングプール／排出量のスナップショット（累積プール、分配比率、Vaultの重み）
• /api/recent — 最近のオンチェーンアクティビティ

---

ツール

ツール	引数	説明
get_project_info	—	/.well-known/ai.jsonと、人向けに構成したsummary
get_collection_stats	—	ライブ統計：供給量、価格、baseBits、クールダウン、一時停止フラグ
get_card	tokenId	カードのメタデータ（/api/meta/{tokenId}）
get_leaderboard	limit?（デフォルト25）	limit件に絞ったポイントランキング
get_pool	—	ステーキングプール：累積プール、分配比率、Vaultの重み（未分配）
get_recent_activity	limit?（デフォルト10）	limit件に絞った最近のイベント
verify_nonce	miner、nonce	nonceの作業をローカルで検証（トランザクションなし）：{work, leadingZeroBits, valid}
find_nonce	miner、maxAttempts?（≤5M）	有効になるまでnonceを0から探索（実時間の上限は約20秒）
get_mining_guide	—	ライブの価格／難易度／クールダウンを含む、ミント手順のガイド

プルーフ・オブ・ワーク

nonceが有効となる条件：

work = keccak256(abi.encodePacked(uint256 chainId, address core, address miner, uint256 nonce))
leadingZeroBits(work) >= baseBits

verify_nonceとfind_nonceは、viemのkeccak256を使ってconcatHex([chainId, core, miner, nonce])に対する計算をローカルで行います。結果はSolidityのabi.encodePackedとバイト単位で完全に一致します。

プロンプト

プロンプト	引数	説明
project_overview	—	初めての人にゲームを紹介します（info ツールと stats ツールを呼び出します）
start_mining	wallet?	nonce の見つけ方と正確な mint トランザクションを順を追って説明します

---

ホスト型 HTTP MCP

stdio より HTTP を優先しますか？ 同じサーバーをこちらでもホストしています：

https://spiritcards.fun/api/mcp

---

ライセンス

MIT © 2026 Spirit Cards (Proof of Card)。LICENSE を参照してください。