dero-mcp-server 0.4.3 → 0.4.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +8 -8
- package/SKILL.md +4 -2
- package/data/docs-index.json +125 -125
- package/dist/citations.d.ts.map +1 -1
- package/dist/citations.js +48 -0
- package/dist/citations.js.map +1 -1
- package/dist/composites/_shared.d.ts +27 -2
- package/dist/composites/_shared.d.ts.map +1 -1
- package/dist/composites/_shared.js +50 -6
- package/dist/composites/_shared.js.map +1 -1
- package/dist/composites/explain-smart-contract.d.ts +6 -2
- package/dist/composites/explain-smart-contract.d.ts.map +1 -1
- package/dist/composites/explain-smart-contract.js +26 -2
- package/dist/composites/explain-smart-contract.js.map +1 -1
- package/dist/composites/recommend-docs-path.d.ts.map +1 -1
- package/dist/composites/recommend-docs-path.js +70 -8
- package/dist/composites/recommend-docs-path.js.map +1 -1
- package/dist/composites/tela-get-doc-content.d.ts +51 -0
- package/dist/composites/tela-get-doc-content.d.ts.map +1 -0
- package/dist/composites/tela-get-doc-content.js +82 -0
- package/dist/composites/tela-get-doc-content.js.map +1 -0
- package/dist/composites/tela-inspect.d.ts +27 -0
- package/dist/composites/tela-inspect.d.ts.map +1 -0
- package/dist/composites/tela-inspect.js +126 -0
- package/dist/composites/tela-inspect.js.map +1 -0
- package/dist/docs-parse.d.ts +18 -0
- package/dist/docs-parse.d.ts.map +1 -1
- package/dist/docs-parse.js +79 -1
- package/dist/docs-parse.js.map +1 -1
- package/dist/docs.d.ts +10 -0
- package/dist/docs.d.ts.map +1 -1
- package/dist/docs.js +223 -36
- package/dist/docs.js.map +1 -1
- package/dist/http-server.d.ts.map +1 -1
- package/dist/http-server.js +5 -1
- package/dist/http-server.js.map +1 -1
- package/dist/server.d.ts +2 -0
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +79 -18
- package/dist/server.js.map +1 -1
- package/dist/tela-parse.d.ts +114 -0
- package/dist/tela-parse.d.ts.map +1 -0
- package/dist/tela-parse.js +242 -0
- package/dist/tela-parse.js.map +1 -0
- package/dist/tool-descriptions.d.ts +3 -1
- package/dist/tool-descriptions.d.ts.map +1 -1
- package/dist/tool-descriptions.js +21 -2
- package/dist/tool-descriptions.js.map +1 -1
- package/package.json +6 -3
package/README.md
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
# DERO MCP server
|
|
2
2
|
|
|
3
|
-
> **A read-only Model Context Protocol server for the DERO privacy blockchain** — a private-by-default Layer 1 with encrypted balances, private smart contracts (DVM-BASIC), and no public transaction graph. 21 daemon primitives +
|
|
3
|
+
> **A read-only Model Context Protocol server for the DERO privacy blockchain** — a private-by-default Layer 1 with encrypted balances, private smart contracts (DVM-BASIC), and no public transaction graph. 21 daemon primitives + 9 composite tools (including TELA on-chain app inspection), with a bundled documentation index spanning derod, tela, hologram, and deropay.
|
|
4
4
|
|
|
5
5
|
[](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.DHEBP/dero-mcp-server)
|
|
6
6
|
[](https://github.com/DHEBP/dero-mcp-server/actions/workflows/ci.yml)
|
|
7
7
|
[](https://glama.ai/mcp/servers/DHEBP/dero-mcp-server)
|
|
8
8
|
|
|
9
|
-
**Registry listing:** `io.github.DHEBP/dero-mcp-server` · **Version:** `0.
|
|
9
|
+
**Registry listing:** `io.github.DHEBP/dero-mcp-server` · **Version:** `0.4.4` · **Transports:** `stdio` (default, npm package) · `streamable-http` (`--http`, for self-hosting)
|
|
10
10
|
|
|
11
11
|
---
|
|
12
12
|
|
|
@@ -32,7 +32,7 @@ Get a working DERO MCP connection in under 5 minutes.
|
|
|
32
32
|
|
|
33
33
|
### What you need
|
|
34
34
|
|
|
35
|
-
- **Node.js
|
|
35
|
+
- **Node.js 20+** ([install](https://nodejs.org)) — verify with `node --version`.
|
|
36
36
|
- **An MCP host** — Claude Desktop, Cursor, OpenCode, or ChatGPT with Custom Connectors. This walkthrough uses Claude Desktop; the JSON config below works identically in Cursor and OpenCode.
|
|
37
37
|
- **Optional:** a local DERO daemon. If one is running on `127.0.0.1:10102`, the server detects and uses it automatically; otherwise it falls back to a public RPC, so it works with zero setup. Run your own for production — [how to](https://derod.org/basics/running-a-node.md).
|
|
38
38
|
|
|
@@ -133,7 +133,7 @@ For multi-step agent recipes, per-tool guidance, error contract, and the composi
|
|
|
133
133
|
|
|
134
134
|
## Requirements
|
|
135
135
|
|
|
136
|
-
- Node.js **
|
|
136
|
+
- Node.js **20+**
|
|
137
137
|
- A reachable DERO daemon with RPC enabled (local node or your own remote URL).
|
|
138
138
|
|
|
139
139
|
## Install & build
|
|
@@ -269,9 +269,9 @@ curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.DHE
|
|
|
269
269
|
|
|
270
270
|
## MCP Surface
|
|
271
271
|
|
|
272
|
-
- **Tools (
|
|
273
|
-
- **Resources (
|
|
274
|
-
- **Prompts (
|
|
272
|
+
- **Tools (30):** 21 daemon read/analysis primitives + 9 composites, including TELA app inspection (`tela_inspect`, `tela_get_doc_content`) and docs retrieval (`dero_docs_search`, `dero_docs_get_page`, `dero_docs_list`)
|
|
273
|
+
- **Resources (4):** `dero://mcp/server-info`, `dero://mcp/safety-boundary`, `dero://mcp/example-flows`, `dero://mcp/composites`
|
|
274
|
+
- **Prompts (5):** `network_health_check`, `inspect_smart_contract`, `trace_transaction`, `find_dero_docs_for_intent`, `estimate_deploy_for_contract`
|
|
275
275
|
|
|
276
276
|
## Error Contract
|
|
277
277
|
|
|
@@ -305,8 +305,8 @@ Common `code` values:
|
|
|
305
305
|
## Roadmap
|
|
306
306
|
|
|
307
307
|
- Optional wallet-RPC tools behind `DERO_ENABLE_WALLET_RPC=1` + separate URL.
|
|
308
|
-
- Streamable HTTP transport for hosted MCP.
|
|
309
308
|
- Stricter typing / OpenAPI-derived tool schemas.
|
|
309
|
+
- TELA-aware contract tooling (INDEX/DOC inspection, on-chain app discovery).
|
|
310
310
|
|
|
311
311
|
## License
|
|
312
312
|
|
package/SKILL.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: dero
|
|
3
3
|
description: Query the DERO privacy blockchain and its documentation through the dero-mcp-server. Use for any DERO ecosystem question — node setup, smart contracts (DVM-BASIC), wallets, TELA apps, RPC methods, ports, privacy mechanics, transaction tracing, contract inspection.
|
|
4
4
|
metadata:
|
|
5
|
-
version: 0.
|
|
5
|
+
version: 0.4.4
|
|
6
6
|
homepage: https://derod.org
|
|
7
7
|
mcp_package: dero-mcp-server
|
|
8
8
|
mcp_transport: stdio | streamable-http
|
|
@@ -39,7 +39,7 @@ Before answering the first user question that needs DERO knowledge, read the MCP
|
|
|
39
39
|
|
|
40
40
|
1. `dero://mcp/server-info` — server metadata, tool list, resource list, prompt names
|
|
41
41
|
2. `dero://mcp/example-flows` — agent flow recipes (composites first, primitives second)
|
|
42
|
-
3. `dero://mcp/composites` — full catalog of the
|
|
42
|
+
3. `dero://mcp/composites` — full catalog of the 9 composite tools and when to use each
|
|
43
43
|
4. `dero://mcp/safety-boundary` — read-only posture, excluded methods, write-path guidance
|
|
44
44
|
|
|
45
45
|
These four resources document the canonical agent workflows. Skim them once per session.
|
|
@@ -77,6 +77,8 @@ The MCP exposes both **primitive** tools (one daemon RPC method per tool) and **
|
|
|
77
77
|
| `trace_transaction_with_context` | get_transaction + (if SC install) get_sc | "what is this tx", "is this confirmed", "what contract did this deploy" |
|
|
78
78
|
| `audit_chain_artifact_claim` | (varies) | Verify a chain-related claim end-to-end |
|
|
79
79
|
| `dero_forge_demo_proof` | (varies) | Generate demo proof strings for testing |
|
|
80
|
+
| `tela_inspect` | get_sc + manual TELA schema parsing | User references a TELA SCID / `.tela` app: "what is this TELA contract", "what files does this app have" (auto-detects INDEX vs DOC) |
|
|
81
|
+
| `tela_get_doc_content` | get_sc + comment-block extraction | User wants the actual file content (HTML/CSS/JS) a TELA-DOC stores |
|
|
80
82
|
|
|
81
83
|
Fall back to primitives only when the composite is unavailable or returns `_meta.error`.
|
|
82
84
|
|