オルディスカンMCP

オルディスカンMCP v1

Ordiscan API 統合による MCP フレームワーク HTTP サーバー実装。

特徴

ポート1337のHTTPストリームトランスポート
リアルタイム通信のためのストリーム応答モード
包括的なOrdiscan API統合（29ツール）
Zod スキーマ検証を使用した TypeScript 実装
詳細なエラー処理と応答フォーマット
直接 API 接続 (プロキシは不要)
ベアラートークン認証
Ordiscan API によって処理されるレート制限

API接続と認証

直接接続

すべてのツールは、プロキシを必要とせずにOrdiscan API（ api.ordiscan.com ）に直接接続します。これにより、以下のことが保証されます。

応答時間の短縮
遅延の低減
追加の設定は不要
直接的なエラー処理
Ordiscan APIによる自動レート制限

認証

すべてのツールには、ベアラートークンを使用した認証が必要です。

API キーは次のいずれかの方法で提供する必要があります。
1. 各ツール呼び出しのパラメータとして（ apiKeyパラメータ）
2. ORDISCAN_API_KEY環境変数を通じて
認証にはベアラートークン形式を使用します
すべてのリクエストにはAuthorization: Bearer <your-api-key>ヘッダーが含まれます
無効または欠落したAPIキーは認証エラーを引き起こします

設定

依存関係をインストールします:

npm install

プロジェクトをビルドします。

npm run build

MCP クライアントを構成します。

{
  "mcpServers": {
    "ordiscanmcpv1": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-deployed-server.com/mcp"  
      ]
    }
  }
}

URL: ( http://localhost:1337/mcp )

サーバーを起動します。

npm start

ホットリロードを使用した開発の場合:

npm run dev

リクエストとともにキーを一度渡すだけで、準備完了です。

プロジェクト構造

ordiscanmcpv1/
├── src/
│   ├── tools/
│   │   ├── ordiscan-utils.ts
│   │   ├── ordiscan.ts            # Main Ordiscan Tool
│   │   │
│   │   ├── # Address Tools
│   │   ├── ordiscan-utxo.ts
│   │   ├── ordiscan-inscriptions.ts
│   │   ├── ordiscan-inscriptions-detail.ts
│   │   ├── ordiscan-runes-balance.ts
│   │   ├── ordiscan-brc20-balance.ts
│   │   ├── ordiscan-rare-sats.ts
│   │   │
│   │   ├── # Activity Tools
│   │   ├── ordiscan-inscriptions-activity.ts
│   │   ├── ordiscan-runes-activity.ts
│   │   ├── ordiscan-brc20-activity.ts
│   │   │
│   │   ├── # Transaction Tools
│   │   ├── ordiscan-tx-info.ts
│   │   ├── ordiscan-tx-inscriptions.ts
│   │   ├── ordiscan-tx-inscription-transfers.ts
│   │   ├── ordiscan-tx-runes.ts
│   │   │
│   │   ├── # Inscription Tools
│   │   ├── ordiscan-inscription-info.ts
│   │   ├── ordiscan-inscription-traits.ts
│   │   ├── ordiscan-inscriptions-list.ts
│   │   ├── ordiscan-inscriptions-detail.ts
│   │   │
│   │   ├── # Collection Tools
│   │   ├── ordiscan-collections-list.ts
│   │   ├── ordiscan-collection-info.ts
│   │   ├── ordiscan-collection-inscriptions.ts
│   │   │
│   │   ├── # Rune Tools
│   │   ├── ordiscan-runes-list.ts
│   │   ├── ordiscan-rune-market.ts
│   │   ├── ordiscan-rune-name-unlock.ts
│   │   │
│   │   ├── # BRC-20 Tools
│   │   ├── ordiscan-brc20-list.ts
│   │   ├── ordiscan-brc20-info.ts
│   │   │
│   │   ├── # Sat Tools
│   │   ├── ordiscan-sat-info.ts
│   │   ├── ordiscan-utxo-rare-sats.ts
│   │   └── ordiscan-utxo-sat-ranges.ts
│   │
│   └── index.ts
├── package.json
├── tsconfig.json
└── README.md

パラメータ処理

すべてのツールはordiscan-utils.tsの堅牢なパラメータ処理ユーティリティを使用します。

柔軟な番号処理

flexibleNumber() : 数値パラメータとして文字列と数値の両方の入力を受け入れる
- 文字列の数値を整数に自動的に変換します
- 該当する場合は数値範囲を検証します
- ページ番号、序数、ブロックの高さに使用されます

柔軟な列挙型の処理

flexibleEnum() : 文字列入力を定義済みの値と照合して検証する
- 並べ替え順序に使用されます（「最新」/「最古」）
- 型フィルターやその他の列挙値に使用されます
- 無効な入力に対して明確なエラーメッセージを表示します

これらのユーティリティは、型の安全性と検証を維持しながら、すべてのツール間で一貫したパラメータ処理を保証します。

利用可能なツール（合計29個）

1. メインツール

ordiscan_main : ルーン情報とステータスの汎用ツール

2. アドレスツール (6)

UTXOツール: ビットコインアドレスが所有するすべてのUTXOを取得する
基本および詳細な刻印ツール: 住所の刻印情報を取得します
ルーンバランスツール: アドレスのルーンバランスを取得します
BRC-20 残高ツール: アドレスの BRC-20 トークン残高を取得します
レアサッツツール: アドレスが所有するレアサッツを取得する

3. アクティビティツール（3）

碑文アクティビティツール: 住所の碑文の移転を追跡する
ルーンアクティビティツール: アドレスのルーン転送を追跡する
BRC-20 アクティビティツール: アドレスの BRC-20 トークン転送を追跡する

4. 取引ツール (4)

取引情報ツール: 詳細な取引情報を取得する
トランザクション刻印ツール: トランザクションの刻印を取得する
トランザクション刻印転送ツール: トランザクション内の刻印転送を追跡します
トランザクションルーンツール: トランザクション内のルーン転送を追跡する

5. 刻印ツール（4）

碑文情報ツール: 碑文の詳細情報を取得します
碑文特性ツール: 碑文の特性を取得する
碑文リストツール: すべての碑文のページ区切りリストを取得します
碑文移転ツール: 碑文の移転を追跡する

6. 収集ツール (3)

コレクションリストツール: ページ分けされたコレクションのリストを取得します
コレクション情報ツール: コレクションの詳細情報を取得します
コレクションの碑文ツール: コレクション内の碑文を取得する

7. ルーンツール（3）

ルーンリストツール: すべてのルーンのリストを取得します
ルーン市場情報ツール: ルーンの市場情報を取得する
ルーン名ロック解除ツール: ルーン名が使用可能かどうかを確認

8. BRC-20ツール（2）

BRC-20 リストツール: すべての BRC-20 トークンのリストを取得します
BRC-20トークン情報ツール: BRC-20トークンの詳細情報を取得します

9. 衛星ツール (3)

衛星情報ツール: 特定の衛星に関する情報を取得する
UTXO レア衛星ツール: UTXO でレア衛星を取得します
UTXO Sat Rangesツール: UTXOのSat Rangesを取得する

ツールの例

碑文情報ツール

特定の碑文に関する詳細な情報を取得します。

ツール名: ordiscan_inscription_info

パラメータ:

id (文字列): 碑文ID (例: b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0)
apiKey (文字列、オプション): Ordiscan APIキー

応答例:

{
  "success": true,
  "formatted": {
    "id": "b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0",
    "number": 123456,
    "type": "image/png",
    "timestamp": "2024-01-01 12:00:00",
    "sat": "1,234,567",
    "content_url": "https://ordinals.com/content/...",
    "collection": "example-collection",
    "owner": {
      "address": "bc1...",
      "output": "txid:vout"
    },
    "genesis": {
      "address": "bc1...",
      "output": "txid:vout"
    }
  }
}

ルーンマーケットツール

特定のルーンの市場情報を取得します。

ツール名: ordiscan_rune_market

パラメータ:

name (文字列): ルーンの一意の名前（スペースなし）
apiKey (文字列、オプション): Ordiscan APIキー

応答例:

{
  "success": true,
  "formatted": {
    "price": {
      "sats": "1,234.56",
      "usd": "$0.50"
    },
    "market_cap": {
      "btc": "12.3456",
      "usd": "$500,000"
    }
  }
}

BRC-20 情報ツール

BRC-20 トークンの詳細情報を取得します。

ツール名: ordiscan_brc20_info

パラメータ:

tick (文字列): トークンの一意の目盛り
apiKey (文字列、オプション): Ordiscan APIキー

応答例:

{
  "success": true,
  "formatted": {
    "tick": "ORDI",
    "supply": {
      "max": "21,000,000",
      "minted": "15,000,000",
      "remaining": "6,000,000",
      "percent_minted": "71.43%"
    },
    "market": {
      "price_usd": "$1.23",
      "market_cap_usd": "$18,450,000",
      "fully_diluted_market_cap_usd": "$25,830,000"
    }
  }
}

エラー処理

すべてのツールには包括的なエラー処理が含まれています。

APIキーの検証
ネットワークリクエストエラー
無効な入力検証
Ordiscan APIからの応答のレート制限
詳細なエラーメッセージ

レスポンスのフォーマット

各ツールは、生の応答とフォーマットされた応答の両方を提供します。

dataフィールドの生データ
formattedフィールド内の人間が読める形式のデータ
すべてのツールで一貫したエラー形式
適切な数値書式と日付のローカライズ

セキュリティに関する推奨事項

APIキー管理

コード内にAPIキーをハードコードしないでください
APIキーの保存に環境変数を使用する
APIキーを定期的にローテーションする
開発と本番で異なるAPIキーを使用する

エラー処理

サーバーは安全なエラー処理を実装します。

エラーメッセージには機密情報が含まれていない
適切なHTTPステータスコード
構造化されたエラー応答
内部を公開せずにエラーを記録する

入力検証

すべてのツールは厳密な入力検証を使用します。

すべてのパラメータに対する Zod スキーマ検証
TypeScriptによる型チェック
数値入力に対する柔軟な数値処理
列挙値の文字列検証

レート制限

レート制限はOrdiscan APIによって処理されます。

追加のレート制限は不要
APIキーベースのレート制限
レート制限超過時の適切なエラー応答
自動レート制限処理

OrdiscanMCP

Integrations