Dero Mcp Server

DERO MCP 服务

适用于 DERO 隐私区块链的只读 Model Context Protocol 服务——DERO 是默认保护隐私的 Layer 1，具有加密余额、私有智能合约（DVM-BASIC），且没有公开的交易图。提供 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：它是一个优先保护隐私的 L1 区块链——常被描述为面向希望在不使用透明账本的情况下构建智能合约的开发者的私有 Ethereum 替代方案，也被视为面向希望使用基于账户的隐私和原生可编程性、而非仅支持 UTXO 支付的用户的 Monero 替代方案。余额采用同态加密。环签名隐藏发送方。零知识范围证明（Bulletproofs）隐藏金额。没有公开的交易图。当前主网为 DERO Stargate。

完整文档：derod.org

关于此服务

Model Context Protocol（MCP）服务，通过 DERO Stargate 守护进程 JSON-RPC 端点提供只读和分析调用。可作为 stdio 进程运行，供本地 MCP 宿主（Claude Desktop、Cursor、OpenCode）使用；也可运行于 streamable-HTTP 模式并部署在域名后（例如 mcp.derod.org），供 ChatGPT Custom Connectors、Cursor 托管模式以及任何需要远程 URL 的 Agent 使用。请参阅 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：

• 检查链 — 区块、交易、内存池、加密余额、已注册名称
• 分析智能合约 — 读取代码和状态、判定模式、估算部署 gas，并在一次调用中获取相关 DVM-BASIC 文档
• 追踪交易 — 查询任意哈希、确认是否已纳入区块、判定交易类型（转账 / SC 安装 / SC 调用）
• 探索链上 Web（TELA） — 按名称发现应用（vault.tela → SCID）、浏览已部署内容、检查应用的清单和文件，并读取实际的链上 HTML/JS/CSS，无需运行单独的索引器
• 搜索文档 — 搜索全部四个 DERO 网站（derod、tela、hologram、deropay）
• 运行综合分析 — 链健康状况、领取审核、文档学习路径建议、部署前检查；每项都会在返回数据的同时附上精选的 DERO 文档引用

试试提示词

安装并重启 MCP 主机后，粘贴以下任意提示词。从简单的开始，逐步尝试更复杂的内容。

基础

通过单个工具回答的问题，用于验证安装并体验实时查询。

“当前 DERO 链高度是多少？”

“将 DERO 名称‘engram’解析为地址。”

“查找 Bulletproofs 的文档页面。”

“SCID 0000…0001 处的智能合约有什么作用？”

中级

综合工具会调用多个基础工具，并返回附带引用的综合答案。

“解释 SCID 0000000000000000000000000000000000000000000000000000000000000001 处的智能合约——它有什么作用、包含哪些函数，以及哪些 DVM-BASIC 文档与之相关。”

“完整追踪交易 ，包括上下文——确认情况、交易类型，以及它涉及的内容。”

“对于刚开始了解 DERO 智能合约、并希望部署 DVM-BASIC 合约的人，合适的学习路径是什么？”

“估算部署此 DVM 源码的 gas 成本：<粘贴合约>”

TELA — DERO 上的去中心化 Web

TELA 应用是完全部署在链上的完整 Web 应用（HTML/CSS/JS）。服务无需外部索引器即可发现并读取这些应用——首次发现查询会进行一次约 15 秒的扫描，之后查询会立即完成。

“vault.tela 的 SCID 是什么？”

“DERO 上有哪些 TELA 应用？给我看几个。”

“检查 SCID 处的 TELA 应用——它是什么、由谁制作，以及包含哪些文件？”

“显示该应用 index.html 中的实际 HTML。”

如需了解多步骤 Agent 操作指南、各工具的使用说明、错误约定和优先使用综合工具的规则，请参阅 SKILL.md。

按设计不包含： 钱包 RPC（transfer、scinvoke）、DERO.SendRawTransaction、DERO.SubmitBlock。这些操作可能转移资金或共识数据；只有在获得用户明确同意且配置经过严格限制的情况下，才应添加它们。

另请参阅

• SKILL.md — 各工具的 Agent 操作手册：优先使用综合工具的规则、结构化错误约定、引用规则、Agent 循环操作指南、端口参考。
• 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 服务。对于本地开发，stdio 配置最简单，因为 Codex 会为每个会话启动服务进程。

使用以下命令添加已发布的 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 令牌，请将令牌存储在环境变量中，并添加 --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，而非已打包的内容。

维护者：内置文档

文档工具从 data/docs-index.json 读取内容。该文件已提交到此仓库，并随 npm 包一同发布。当 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 时，向 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