Spirit Cards

fun.spiritcardsv0.1.0更新於 Oct 6, 2026

Read-only Spirit Cards MCP: PoW-mined NFT cards on Robinhood Chain — stats, cards, leaderboard.

已驗證Streamable HTTP可網頁執行FinanceData & Analytics

概覽

AI 產生的概覽

唯讀存取 Robinhood Chain 上以工作量證明鑄造的集換式卡牌遊戲 Spirit Cards：統計、卡牌、排行榜、獎池，以及本機 nonce 驗證。

功能
提供 Spirit Cards 遊戲的唯讀工具：專案資訊、即時收藏統計（供應量、價格、所需難度、冷卻時間）、依 token ID 查詢卡牌中繼資料、積分排行榜、質押獎池快照與近期鏈上活動。也可在本機驗證挖礦 nonce，並可搜尋有效 nonce，另有介紹遊戲與說明鑄造流程的提示。
適用情境
適合需要檢視或說明 Spirit Cards 收藏、查詢某張卡牌、查看即時統計或排行榜，或在不使用錢包、不發送交易的情況下驗證與搜尋工作量證明 nonce 的情境。
執行需求
需要本機 Node.js 執行環境以透過 npx 執行該 npm 套件，或使用託管的 HTTP 端點。選用環境變數 SPIRIT_CARDS_API 可設定 API 基礎網址，預設指向專案網站。唯讀 GET 端點需要網路存取。
安裝前請注意
此伺服器自稱唯讀：沒有金鑰、沒有機密、不簽章、不發送交易，所有網路請求都是普通 GET。nonce 搜尋運算量大，受嘗試次數與時間上限限制。資料來自第三方託管 API，查詢會傳送到該服務。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Spirit Cards，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "spirit-cards-mcp": {
      "type": "http",
      "url": "https://spiritcards.fun/api/mcp"
    }
  }
}

README

spirit-cards-mcp

A read-only Model Context Protocol (MCP) server for Spirit Cards (Proof of Card) — a proof-of-work minted collectible card game on Robinhood Chain — mainnet chainId 4663, live since 2026-10-05.

It runs over stdio, so Claude Desktop and Cursor can launch it with npx. It fetches live game data from the hosted web API and computes the proof-of-work locally with viem — so an agent can inspect the collection, verify a nonce, or even grind a valid nonce, without a wallet, a private key, or a single transaction.

Read-only. No keys, no secrets, no signing, no sending. Every network call is a plain GET.

Quick start

Run with npx (after publishing)

bash
npx spirit-cards-mcp

Run from source

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

The server speaks MCP over stdin/stdout and logs only to stderr — it is normally launched by an MCP client, not by hand.

Use in Claude Desktop

Add this to claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows):

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

Use in Cursor

Add this to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

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

Configuration

Env varDefaultMeaning
SPIRIT_CARDS_APIhttps://spiritcards.funBase URL of the hosted site/API

All data endpoints are read-only GETs:

  • /.well-known/ai.json — project descriptor (chain id, core contract, mechanics, links)
  • /stats/current.json — live supply, price, required difficulty (baseBits), cooldown
  • /api/meta/{tokenId} — card metadata
  • /api/points — points leaderboard
  • /api/pool — staking pool / emissions snapshot (accrued pool, split shares, vault weight)
  • /api/recent — recent on-chain activity

Tools

ToolArgsDescription
get_project_info—/.well-known/ai.json + a composed human summary
get_collection_stats—Live stats: supply, price, baseBits, cooldown, paused flag
get_cardtokenIdCard metadata (/api/meta/{tokenId})
get_leaderboardlimit? (default 25)Points leaderboard, trimmed to limit
get_pool—Staking pool: accrued pool, split shares, vault weight (undistributed)
get_recent_activitylimit? (default 10)Recent events, trimmed to limit
verify_nonceminer, nonceVerify a nonce's work locally (no tx): {work, leadingZeroBits, valid}
find_nonceminer, maxAttempts? (≤5M)Grind nonce 0.. until valid (~20 s wall cap)
get_mining_guide—Step-by-step mint guide with live price/difficulty/cooldown

Proof-of-work

A nonce is valid when:

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

Both verify_nonce and find_nonce compute this locally with viem's keccak256 over concatHex([chainId, core, miner, nonce]) — byte-for-byte identical to Solidity's abi.encodePacked.

Prompts

PromptArgsDescription
project_overview—Introduce the game to a newcomer (calls the info + stats tools)
start_miningwallet?Walk through finding a nonce and the exact mint transaction

Hosted HTTP MCP

Prefer HTTP over stdio? The same server is also hosted at:

https://spiritcards.fun/api/mcp

License

MIT © 2026 Spirit Cards (Proof of Card). See LICENSE.

來源：README.md，提交 0b2fe7b

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v0.1.0最新Oct 6, 2026