Dero Mcp Server

DERO MCP サーバー

DERO プライバシーブロックチェーン向けの読み取り専用 Model Context Protocol サーバー — 残高がデフォルトで暗号化され、プライベートスマートコントラクト（DVM-BASIC）を備え、公開トランザクショングラフを持たないプライバシー重視の Layer 1 です。21 個のデーモンプリミティブと 12 個の複合ツール（オンチェーンアプリの TELA 検査や dURL→SCID の検出を含む）に加え、derod、tela、hologram、deropay を網羅するドキュメントインデックスを同梱しています。

レジストリ掲載名： io.github.DHEBP/dero-mcp-server · バージョン： 0.6.0 · トランスポート： stdio（デフォルト、npm パッケージ）· streamable-http（--http、セルフホスト用）

---

MCP サーバーとは

MCP サーバー（Model Context Protocol）は、AI アシスタント（Claude Desktop、Cursor、OpenCode、Custom Connectors を利用する ChatGPT など）に、ユーザーの代わりに特定のツールを呼び出す機能を提供する小さなプログラムです。AI が記憶を頼りに DERO について 話す だけでなく、実際に情報を調べられるようになります。ブロックの取得、コントラクトの読み取り、ドキュメントの検索、トランザクションの追跡、デプロイの見積もりなどが可能です。

一度インストールして、AI ホストから接続するだけです。それ以降、チャットで尋ねる DERO に関する質問はすべて、AI の学習データの期限ではなく、ライブのチェーンデータと同梱のドキュメントコーパスに照会されます。

DERO とは

DERO を初めて知る方へ：DERO はプライバシーを重視する L1 ブロックチェーンです。透明な台帳なしでスマートコントラクトを使いたい開発者にとってのイーサリアムのプライベートな代替手段、あるいは UTXO のみの送金ではなく、ネイティブのプログラマビリティを備えたアカウントベースのプライバシーを求めるユーザーにとってのMonero の代替手段とよく説明されます。残高は準同型暗号化されます。リング署名によって送信者が隠されます。ゼロ知識レンジプルーフ（Bulletproofs）によって金額が隠されます。公開トランザクショングラフは存在しません。現在のメインネットは DERO Stargate です。

ドキュメント全文：derod.org

このサーバーについて

Model Context Protocol（MCP）サーバーは、DERO Stargate デーモンの JSON-RPC エンドポイントに対する読み取り専用および分析用の呼び出しを提供します。ローカルの MCP ホスト（Claude Desktop、Cursor、OpenCode）向けには stdio プロセスとして、またはドメイン（例：mcp.derod.org）の背後でstreamable-HTTPモードとして動作し、ChatGPT Custom Connectors、Cursor のホストモード、リモート URL を必要とするあらゆるエージェントに対応します。セルフホスト可能なデプロイの参考例は deploy/ を参照してください。

クイックスタート

5 分以内に DERO MCP 接続を動作させます。

必要なもの

• Node.js 20 以降（インストール） — node --version で確認します。
• MCP ホスト — Claude Desktop、Cursor、OpenCode、または Custom Connectors を利用する ChatGPT。この手順では Claude Desktop を使用しますが、以下の JSON 設定は Cursor と OpenCode でも同様に使えます。
• 任意： ローカルの DERO デーモン。127.0.0.1:10102 で稼働している場合、サーバーが自動的に検出して使用します。稼働していない場合はパブリック RPC にフォールバックするため、設定なしでも動作します。本番環境では自身で実行してください — 手順。

1. MCP ホストの設定ファイルを開く

ホスト	場所
Claude Desktop（macOS）	~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop（Windows）	%APPDATA%\Claude\claude_desktop_config.json
Cursor	Settings → MCP → Add Server
OpenCode	Settings → MCP → Add Server
Codex CLI / IDE	codex mcp add または ~/.codex/config.toml

ファイルが存在しない場合は作成してください。

2. DERO MCP サーバーを追加する

{
  "mcpServers": {
    "dero-daemon": {
      "command": "npx",
      "args": ["-y", "dero-mcp-server"]
    }
  }
}

npx を使って公開済みの最新バージョンを取得して実行するため、手動でのインストールやビルドは不要です。

サーバーは 127.0.0.1:10102 にあるローカルノードを自動検出します。特定のデーモン（カスタムポートまたはリモート URL）を指定するには、env ブロックを追加してください。

"env": { "DERO_DAEMON_URL": "http://127.0.0.1:10102" }

3. MCP ホストを再起動する

更新するだけでなく、完全に終了してから再度開いてください。MCP サーバーは起動時に読み込まれます。

4. 動作を確認する

新しいチャットで次のように質問します。

「現在の DERO チェーンの高さは？」

数値が返ってくれば接続されています。エラーが表示された場合は、設定ファイルのパスが正しいことと、ホストを更新するだけでなく完全に再起動したことを確認してください。

動作したら、プロンプトを試すに進んで、機能をひととおり確認してください。

---

できること

インストールすると、MCP ホストは自然言語の指示に従って、JSON-RPC を使わずに次のすべてを実行できます。

• チェーンを調査する — ブロック、トランザクション、メンプール、暗号化された残高、登録済みの名前
• スマートコントラクトを分析する — コードと状態の読み取り、パターンの分類、デプロイ時のガスの見積もり、関連する DVM-BASIC ドキュメントの一括取得
• トランザクションを追跡する — 任意のハッシュの検索、取り込みの確認、種類（transfer／SC install／SC call）の分類
• オンチェーンウェブ（TELA）を探索する — 名前からアプリを検索（vault.tela → SCID）、デプロイ済みの内容を閲覧、アプリのマニフェストとファイルを調査し、オンチェーン上の実際の HTML／JS／CSS を読み取る（別途インデクサーを実行する必要はありません）
• ドキュメントを検索する — DERO の 4 つのサイト（derod、tela、hologram、deropay）を横断して検索
• 複合分析を実行する — チェーンの健全性、クレームの監査、ドキュメントの学習パスの推奨、デプロイ前のチェックを実施し、いずれもデータとあわせて厳選された DERO ドキュメントの引用を返す

プロンプトを試す

MCP ホストをインストールして再起動したら、以下のいずれかを貼り付けてください。簡単なものから始めて、徐々に進めましょう。

基本

インストールを確認し、ライブクエリを試す単一ツールの質問です。

「現在の DERO チェーンの高さは？」

「DERO の名前「engram」をアドレスに解決してください。」

「Bulletproofs のドキュメントページを見つけてください。」

「SCID 0000…0001 のスマートコントラクトは何をしますか？」

中級

複数のプリミティブに処理を振り分け、引用付きの統合された回答を返す複合ツールです。

「SCID 0000000000000000000000000000000000000000000000000000000000000001 のスマートコントラクトについて説明してください。何をするのか、どのような関数があるのか、どの DVM-BASIC ドキュメントが関連するのかを教えてください。」

「トランザクション を、確認、分類、関連する対象を含む詳しいコンテキストとあわせて追跡してください。」

「DERO のスマートコントラクトを初めて学ぶ人が DVM-BASIC コントラクトをデプロイする場合、適切な学習順序を教えてください。」

「この DVM ソースのデプロイにかかるガスを見積もってください：<コントラクトを貼り付ける>」

TELA — DERO 上の分散型ウェブ

TELA アプリは、すべてオンチェーンにデプロイされた完全なウェブアプリ（HTML／CSS／JS）です。サーバーは外部インデクサーを使わずにアプリを検出して読み取ります。最初の検出クエリでは一度だけ約 15 秒のスキャンが実行され、その後は瞬時に結果が返ります。

「vault.tela の SCID は何ですか？」

「DERO にはどのような TELA アプリがありますか？いくつか見せてください。」

「SCID の TELA アプリを調査してください。どのようなアプリで、誰が作成し、どのようなファイルがありますか？」

「そのアプリの index.html の実際の HTML を見せてください。」

複数ステップのエージェント向けレシピ、ツールごとのガイダンス、エラー仕様、複合ツール優先のルールについては、SKILL.md を参照してください。

設計上、含まれていない機能： ウォレット RPC（transfer、scinvoke）、DERO.SendRawTransaction、DERO.SubmitBlock。これらは資金やコンセンサスデータを移動させる可能性があるため、明示的なユーザーの同意を得て、セキュリティを厳格に設定した環境でのみ追加してください。

関連項目

• SKILL.md — ツールごとのエージェント向け手順書：複合ツール優先のルール、構造化されたエラー仕様、引用ルール、エージェントループのレシピ、ポート一覧。
• POSITIONING.md — DERO MCP の対象ユーザーと対象外のユーザー、ACP／Stripe／Crossmint／Skyfire との比較、プライバシーに関する方針。

必要条件

• Node.js 20+
• RPC が有効で、到達可能な DERO デーモン（ローカルノードまたは独自のリモート URL）。

インストールとビルド

cd dero-mcp-server
npm install
npm run build

実行します（DERO_DAEMON_URL が設定されていない場合、127.0.0.1:10102 のローカルノードを自動検出し、見つからなければ公開ノードにフォールバックします）。

node dist/index.js

または、明示的な URL を設定します（例：自分のローカルデーモン）。

DERO_DAEMON_URL=http://127.0.0.1:10102 node dist/index.js

デーモンの解決はローカル優先です。DERO_DAEMON_URL が設定されていない場合、サーバーは応答があれば 127.0.0.1:10102 のローカルノードを使用し、応答がなければ組み込みのサードパーティ公開 RPC（82.65.143.182:10102）を使用します。プライバシー保護のため、自分のノードを使用してください。

完全な JSON-RPC URL を貼り付ける場合は、末尾の /json_rpc を削除してください。このサーバーが /json_rpc を追加します。

HTTP モード（セルフホスト可能）

ローカルのサブプロセスを起動できないクライアント（ChatGPT Custom Connectors、Cursor のホストモード、n8n / Zapier との統合）では、サーバーをストリーム可能な HTTP モードで実行し、自分のドメインの背後に配置します。

DERO_MCP_AUTH_TOKEN=$(openssl rand -base64 48) \
  dero-mcp-server --http
# [dero-mcp-server] HTTP listening on 127.0.0.1:8787 (POST /mcp · GET /health)

stdio と HTTP はどちらも MCP 2026-07-28 を提供し、2025 年代のクライアントとの互換性も維持しています。HTTP のやり取りはステートレスで、Mcp-Session-Id は発行しません。2026 年のクライアントは server/discover を介してネゴシエーションを行います。

変数	デフォルト	説明
DERO_MCP_HTTP	未設定	1 に設定するか（または --http を渡すと）、HTTP モードで起動します。
DERO_MCP_HTTP_PORT	8787	リッスンするポートです。
DERO_MCP_HTTP_HOST	127.0.0.1	リッスンするアドレスです。公開するには 0.0.0.0 を指定します（認証と上流 TLS なしでは使用しないでください）。
DERO_MCP_AUTH_TOKEN	未設定	設定すると、すべての /mcp リクエストに Authorization: Bearer <token> が必要です。定時間比較を使用します。

Caddy、自動 TLS、Docker Compose を使ったすぐに利用できるデプロイ方法については、deploy/README.md を参照してください。これは、自分のホストインスタンスを実行するためのセルフホスト用リファレンスです。公開されていた mcp.derod.org インスタンスは 2026-10-10 に廃止されました。npx dero-mcp-server を使用するか、セルフホストしてください。ホスト型インスタンスの背後にある公開デフォルトデーモンでは、CalcSupply より古い GetInfo スケジュール式が使われる場合があります。verify_supply は引き続きオフラインのスケジュール数値を正しいものとして扱います（供給量の検証を参照）。

stdio トランスポート（以下）と HTTP トランスポートは、同じ基盤のサーバーファクトリーを共有しているため、ツールの提供範囲、レスポンス形式、エラーコードはどちらも同じです。

Claude Desktop（OpenCode と Cursor も同じ手順）

claude_desktop_config.json に追加します（macOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json）。

{
  "mcpServers": {
    "dero-daemon": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/dero-mcp-server/dist/index.js"]
    }
  }
}

任意：特定のデーモンに固定するには、"env": { "DERO_DAEMON_URL": "http://127.0.0.1:10102" } を追加します。ローカルノードがデフォルトのポートを使用している場合は不要です。サーバーが自動検出します。

Claude Desktop（または OpenCode / Cursor のホスト）を再起動します。

Cursor（または OpenCode）

Cursor Settings → MCP（または OpenCode の MCP 設定）で、上記と同じ command / args / env を実行するサーバーを追加します。

OpenCode

OpenCode MCP settings で、上記と同じ command / args / env を使うサーバーを追加します。

Codex

Codex は DERO MCP を、ローカル stdio サーバーまたはストリーム可能な HTTP サーバーとしてサポートしています。Codex がセッションごとにサーバープロセスを起動するため、ローカル開発では stdio の設定が最も簡単です。

次のコマンドで公開 npm パッケージを追加します。

codex mcp add dero-daemon --env DERO_DAEMON_URL=http://127.0.0.1:10102 -- npx -y dero-mcp-server

カスタムホストまたはポートを使用する場合は、http://127.0.0.1:10102 をデーモンのベース URL に置き換えます。/json_rpc は含めないでください。このサーバーが追加します。

同等の ~/.codex/config.toml は次のとおりです。

[mcp_servers.dero-daemon]
command = "npx"
args = ["-y", "dero-mcp-server"]

[mcp_servers.dero-daemon.env]
DERO_DAEMON_URL = "http://127.0.0.1:10102"

コピーして使用できる例は .codex/config.example.toml にあります。プロジェクト単位の Codex 設定を使う場合に限り、これを .codex/config.toml に名前変更するかコピーしてください。Codex は信頼済みのプロジェクトでのみプロジェクト設定を読み込みます。

すでに起動しているストリーム可能な HTTP デプロイを使う場合は、代わりに URL を追加します。

codex mcp add dero-daemon --url http://127.0.0.1:8787/mcp

HTTP サーバーでベアラートークンが必要な場合は、トークンを環境変数に保存し、--bearer-token-env-var DERO_MCP_AUTH_TOKEN を追加します。

Codex を再起動するか新しいセッションを開始し、/mcp を実行して dero-daemon が有効であることを確認します。簡単な確認用プロンプトは次のとおりです。

「現在の DERO チェーンの高さはいくつですか？」

環境

変数	デフォルト	説明
DERO_DAEMON_URL	(ローカル優先で自動検出)	デーモンのベースURL（/json_rpcは不要です）。未設定の場合、127.0.0.1:10102のローカルノードに接続可能であれば使用し、接続できない場合はパブリックの代替先（82.65.143.182:10102）を使用します。特定のエンドポイントに固定するには設定してください。
DERO_DOCS_ROOT	バンドルされたインデックス	任意の開発用オーバーライドです。配布済みのバンドルではなく、ローカルのdero-docsクローンをインデックス化してライブMDXを使用するためのパスです。

メンテナー：バンドルされたドキュメント

ドキュメント用ツールは、このリポジトリにコミットされ、npmパッケージに同梱されるdata/docs-index.jsonを読み込みます。dero-docsが変更されたら、インデックスを再ビルドしてください。

npm run release:docs-check
git add data/docs-index.json && git commit -m "Refresh bundled docs index."

または、ActionsのRefresh docs bundleを実行して、PRを作成します。MCP_DOCS_SYNC_TOKENがdocsリポジトリに設定されている場合、dero-docsのmainへのプッシュによって、repository_dispatch経由でこのワークフローを実行できます。

バンドルの更新をマージした後、package.jsonとserver.jsonのパッチバージョンを上げてから、npm publish --otp=...とmcp-publisher publishを実行してください。

テスト

# Check daemon connectivity
npm run doctor

# MCP surface contract checks (tools/resources/prompts + error probe)
npm run smoke:mcp

# Docs retrieval checks (bundled index — no clone required)
npm run smoke:docs

# Run flow tests (10 RPC checks)
npm run test:flows

# Typecheck
npm run typecheck

フローテストはデフォルトのパブリックRPCに対して実行されます。独自のデーモンに対してテストするには、DERO_DAEMON_URLを設定してください。

CIはすべてのプッシュとPRで実行されます。.github/workflows/ci.ymlを参照してください。

公式MCPレジストリ

公開手順（メンテナー向け）：

mcp-publisher validate
mcp-publisher login github
mcp-publisher publish

掲載を確認：

curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.DHEBP/dero-mcp-server"

MCPの機能

• ツール（33）： デーモンの読み取り／分析用プリミティブ21個と複合ツール12個です。verify_supply（オフラインのCalcSupply）、TELAアプリの検査（tela_inspect、tela_get_doc_content）、TELAの検出（dero_durl_to_scid、dero_tela_list_apps）、ドキュメントの取得（dero_docs_search、dero_docs_get_page、dero_docs_list）を含みます。
• リソース（4）： dero://mcp/server-info、dero://mcp/safety-boundary、dero://mcp/example-flows、dero://mcp/composites
• プロンプト（5）： network_health_check、inspect_smart_contract、trace_transaction、find_dero_docs_for_intent、estimate_deploy_for_contract

エラー仕様

ツール呼び出しが失敗すると、サーバーはツールのコンテンツに構造化されたエラーペイロードを返します。

{
  "ok": false,
  "tool": "dero_get_sc",
  "_meta": {
    "error": {
      "code": "RPC_UNREACHABLE",
      "hint": "Confirm daemon is running and reachable, then rerun `npm run doctor`.",
      "retryable": true,
      "raw": "fetch failed"
    }
  }
}

一般的なcodeの値：

• INVALID_INPUT
• RPC_INVALID_PARAMS
• RPC_METHOD_NOT_FOUND
• RPC_HTTP_ERROR
• RPC_UNREACHABLE
• RPC_INVALID_RESPONSE
• TOOL_EXECUTION_ERROR

ロードマップ

• DERO_ENABLE_WALLET_RPC=1と個別のURLで有効化する、任意のウォレットRPCツール。
• より厳密な型付け／OpenAPIから派生したツールスキーマ。
• TELA対応のコントラクトツール（INDEX／DOCの検査、オンチェーンアプリの検出）。

ライセンス

MIT