stellar-pulse-mcp

stellar-pulse-mcp

Model Context Protocol を介して、AI アシスタントに読み取り専用の Stellar 分析を提供します。Stellar のネットワーク状況や手数料、アセットの品質、DEX のオーダーブック、アカウント、DeFi について Claude（または任意の MCP クライアント）に質問すると、公開 API から構造化された回答が得られます。API キーは不要です。署名は行いません。トランザクションも実行しません。

既存の Stellar MCP サーバーは、トランザクションの作成と送信や Soroban コントラクトの開発に重点を置いています。このサーバーは、業務のもう半分、つまりネットワーク上で何が起きているかを把握し、信頼できないものを見つけるためのものです。

ツール	回答する内容
stellar_network_status	最新のレジャー（経過時間、トランザクション数、失敗率、プロトコルバージョン、基本準備金）と手数料水準
stellar_asset	アセットの価格、供給量、保有者数、7 日間の取引高、評価、類似アセットの警告（XLM、USDC、または CODE-ISSUER）
stellar_top_assets	取引高、取引数、支払い数、保有者数、StellarExpert の評価に基づく、最も活発なアセット
stellar_orderbook	ペアの SDEX オーダーブック：最良買値／売値、中値、スプレッド、1％および 5％以内の板の厚み
stellar_account	残高、準備金と未決済オファーを差し引いた使用可能な XLM、署名者、しきい値、クローバックフラグ、最近の支払い
stellar_defi	DefiLlama による Stellar DeFi：TVL、チェーン間の順位、主要プロトコル、カテゴリ別 TVL

プロンプトの例：

• 「現在、Stellar ネットワークは混雑していますか？ 手数料はどうなっていますか？」
• 「この USDC は本物ですか？」（USDC-G... を指定すると、発行者、ドメイン、保有者数、評価を確認します）
• 「SDEX の XLM/USDC オーダーブックの厚みとスプレッドはどのくらいですか？」
• 「このアカウントが実際に使用できる XLM はどのくらいですか？」
• 「Stellar で最大の DeFi プロトコルは何ですか？ また、成長しているのはどれですか？」

安全性に関する詳細が重要な理由

• 同じコードを持つアセットが多数あります。 誰でも USDC という名前のトークンを発行できます。コードだけを指定すると、stellar_asset は最も取引量の多いアセットを選び、同じコードを使うアセットがほかにいくつあるかを伝えます。また、確認済みのホームドメインがない発行者、評価の低い発行者、保有者数が非常に少ないアセット、取引量のないアセットにフラグを立てます。
• シークレットキーは拒否されます。 S で始まる値はネットワーク呼び出しの前に直ちに拒否され、応答にも含まれません。このサーバーが必要とするのは、G で始まる公開アドレスだけです。
• 使用可能な XLM は推測ではなく計算されます： (2 + subentries + sponsoring - sponsored) x base reserve から、未決済オファーでロックされている XLM を差し引きます。準備金は最新のレジャーから読み取ります。

インストール

Node.js 20 以降が必要です。最も手軽なのは npx を使う方法で、クローンは不要です。

Claude Code

claude mcp add stellar-pulse -- npx -y stellar-pulse-mcp

Windows では cmd から実行してください（PowerShell は -- を処理してしまうため）。また、Claude Code から起動できるように npx をラップしてください。

claude mcp add stellar-pulse -- cmd /c npx -y stellar-pulse-mcp

現在のプロジェクトだけでなく、すべてのフォルダーで利用できるようにするには、-s user を追加してください。

Claude Desktop

{
  "mcpServers": {
    "stellar-pulse": {
      "command": "npx",
      "args": ["-y", "stellar-pulse-mcp"]
    }
  }
}

Windows では "command": "cmd" と "args": ["/c", "npx", "-y", "stellar-pulse-mcp"] を使用してください。

npm および公式 MCP Registry で io.github.markankamaransheogarat-sys/stellar-pulse-mcp として公開されています。

ソースから実行するには：

git clone https://github.com/markankamaransheogarat-sys/stellar-pulse-mcp.git
cd stellar-pulse-mcp
npm install
npm run build
node dist/index.js

詳細

• データソース： Horizon（台帳、手数料、アカウント、注文板）、StellarExpert（資産の統計と評価）、DefiLlama（TVL）。メインネットのみです。
• 単位： Horizon の金額は小数単位です。StellarExpert の供給量と取引量はストロープ単位で提供され、換算されます（1 XLM = 10,000,000 ストロープ）。
• 1 つのソースが停止しても失敗ではありません。 複数のソースを組み合わせるツールは、利用可能なソースから回答し、失敗したソースを errors フィールドに列挙します。
• キャッシュ： 無料プランへの過剰なリクエストを防ぐため、台帳レベルのデータは 3～4 秒、StellarExpert は 60 秒、DefiLlama は 5 分間キャッシュします。同一のリクエストが同時に行われた場合は、1 回の呼び出しを共有します。
• Depth は、SDEX の注文板で片側あたり最良の 100 レベルを数えます。流動性プールと Soroban DEX は含まれません。
• 投資助言ではありません。 公開データのスナップショットであり、数秒から数分前のものです。

開発

npm run typecheck   # tsc --noEmit over src and tests
npm test            # vitest, all HTTP mocked
npm run build       # compile to dist/
npm run smoke       # live check against the real APIs (needs a build first)

src/sources/* はそれぞれ 1 つの API と通信し、src/tools/* はロジックを格納してそれぞれ 1 つの MCP ツールを登録します。src/stellar.ts はアカウント ID と資産参照を検証し、src/http.ts は共有クライアントです（タイムアウト、上限付き再試行、TTL キャッシュ）。

姉妹プロジェクトの crypto-pulse-mcp は、取引所間の価格、無期限先物のファンディング、ステーブルコインのフローについて同様の機能を提供します。

ライセンス

MIT