ordinals

ordinals-mcp

最も包括的な Bitcoin Ordinals MCP サーバーです。 インスクリプション、ルーン、BRC-20 トークン、コレクション、希少サトシ、マーケットプレイスデータをカバーする 24 個のツールを提供します。Hiro、Ordiscan、Magic Eden の API を、インテリジェントなキャッシュと自動フェイルオーバーで集約します。

唯一の代替手段（ordiscan-mcp）は、npm のダウンロード数が 25 回で、カバー範囲もごく一部にとどまります。このサーバーは本番環境に対応した選択肢です。

インストール

npx ordinals-mcp@latest

グローバルにインストールする場合：

npm install -g ordinals-mcp
ordinals-mcp

設定

MCP 設定（claude_desktop_config.json または ~/.mcp.json）に追加してください：

{
  "mcpServers": {
    "ordinals": {
      "command": "npx",
      "args": ["-y", "ordinals-mcp@latest"],
      "env": {
        "HIRO_API_KEY": "your-key",
        "ORDISCAN_API_KEY": "your-key"
      }
    }
  }
}

HIRO_API_KEY または ORDISCAN_API_KEY のいずれかが必要です。どちらも無料で取得できます：

プロバイダー	レート制限	キーの取得先
Hiro（プライマリ）	500 RPM	platform.hiro.so
Ordiscan（フォールバック）	--	ordiscan.com/docs/api
Magic Eden（オプション）	--	docs.magiceden.io

ツール（24）

インスクリプション（5）

ツール	説明	主なパラメーター
get_inscription	ID または番号を指定してインスクリプションの詳細を取得します	id
search_inscriptions	フィルター（タイプ、MIME、日付範囲）を使ってインスクリプションを検索します	query, filters
get_inscription_content	インスクリプションの生コンテンツを取得します	id
get_inscription_transfers	インスクリプションの転送履歴を取得します	id
get_inscription_traits	インスクリプションの特性と属性を取得します	id

アドレスクエリ（4）

ツール	説明	主なパラメーター
get_address_inscriptions	Bitcoin アドレスが保有するすべてのインスクリプションを取得します	address
get_brc20_balances	アドレスの BRC-20 トークン残高を取得します	address
get_rune_balances	アドレスのルーン残高を取得します	address
get_address_rare_sats	アドレスが保有する希少サトシを取得します	address

ルーン（6）

ツール	説明	主なパラメーター
get_rune_info	ルーンの詳細なメタデータ（エッチング、供給量、保有者）を取得します	rune
list_runes	ページネーションと並べ替えを指定して、すべてのルーンを一覧表示します	offset, limit
get_rune_holders	特定のルーンの上位保有者を取得します	rune
get_rune_activity	ルーンの最近のアクティビティ（ミント、転送、バーン）を取得します	rune
get_rune_market_info	市場データ（フロア価格、取引量、出品情報）を取得します	rune
get_rune_unlock_date	時間ロックされたルーンのロック解除日／利用可能日を取得します	rune

BRC-20（3）

ツール	説明	主なパラメーター
get_brc20_token	トークンの詳細（供給量、上限、保有者、デプロイ情報）を取得します	ticker
get_brc20_activity	BRC-20 トークンの最近のアクティビティを取得します	ticker
get_brc20_holders	BRC-20 トークンの上位保有者を取得します	ticker

コレクション（3）

ツール	説明	主なパラメーター
get_collection_info	コレクションのメタデータ、フロア価格、取引量を取得します	slug
get_collection_inscriptions	コレクション内のインスクリプションを取得します	slug
get_collection_listings	コレクションのマーケットプレイスで有効な出品情報を取得します	slug

サトシとトランザクション（3）

ツール	説明	主なパラメーター
get_sat_info	サトシの希少度、名前、インスクリプション履歴を取得します	sat_number
get_tx_inscriptions	Bitcoin トランザクション内のインスクリプションを取得します	txid
get_tx_runes	Bitcoin トランザクション内のルーン操作を取得します	txid

なぜこれを選ぶのか？

• 24 個のツールで幅広くカバーします。 インスクリプション、ルーン、BRC-20、コレクション、レアサット、マーケットプレイスのデータに対応します。6 つすべてのカテゴリをカバーする Ordinals MCP はほかにありません。
• 複数の API と自動フェイルオーバーに対応します。 Hiro（プライマリ、500 RPM）、Ordiscan（フォールバック）、Magic Eden（マーケットプレイス）を集約します。いずれかの API がレート制限に達すると、リクエストは自動的に次の API に振り分けられます。
• インテリジェントなキャッシュを備えています。 データの種類ごとに TTL を調整しています。サットの希少度（24 時間）、インスクリプションのメタデータ（5 分）、コレクション情報（2 分）、残高（1 分）、マーケットプレイスの出品（30 秒）。障害時には、最後の手段として古いキャッシュを提供します。

アーキテクチャ

Request --> Cache (TTL + ETag)
  |--> HIT: return cached
  |--> MISS:
      |--> Hiro (primary, 500 RPM)
      |     |--> Success: cache + return
      |     |--> Rate limited: Ordiscan (fallback) --> Stale cache (last resort)
      |--> Magic Eden (marketplace-specific)

環境変数

変数	必須	説明
HIRO_API_KEY	はい*	Hiro API キー（無料）
ORDISCAN_API_KEY	はい*	Ordiscan API キー（無料）
MAGIC_EDEN_API_KEY	いいえ	マーケットプレイスのレート制限を緩和します
CACHE_TTL_SECONDS	いいえ	デフォルトのキャッシュ TTL（デフォルト：300）

*少なくとも 1 つが必要です。

開発

git clone https://github.com/ExpertVagabond/ordinals-mcp.git
cd ordinals-mcp
npm install
npm run build
npm run inspector    # MCP Inspector for testing

ライセンス

MIT -- Purple Squirrel Media