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.
Files changed (49) hide show
  1. package/README.md +8 -8
  2. package/SKILL.md +4 -2
  3. package/data/docs-index.json +125 -125
  4. package/dist/citations.d.ts.map +1 -1
  5. package/dist/citations.js +48 -0
  6. package/dist/citations.js.map +1 -1
  7. package/dist/composites/_shared.d.ts +27 -2
  8. package/dist/composites/_shared.d.ts.map +1 -1
  9. package/dist/composites/_shared.js +50 -6
  10. package/dist/composites/_shared.js.map +1 -1
  11. package/dist/composites/explain-smart-contract.d.ts +6 -2
  12. package/dist/composites/explain-smart-contract.d.ts.map +1 -1
  13. package/dist/composites/explain-smart-contract.js +26 -2
  14. package/dist/composites/explain-smart-contract.js.map +1 -1
  15. package/dist/composites/recommend-docs-path.d.ts.map +1 -1
  16. package/dist/composites/recommend-docs-path.js +70 -8
  17. package/dist/composites/recommend-docs-path.js.map +1 -1
  18. package/dist/composites/tela-get-doc-content.d.ts +51 -0
  19. package/dist/composites/tela-get-doc-content.d.ts.map +1 -0
  20. package/dist/composites/tela-get-doc-content.js +82 -0
  21. package/dist/composites/tela-get-doc-content.js.map +1 -0
  22. package/dist/composites/tela-inspect.d.ts +27 -0
  23. package/dist/composites/tela-inspect.d.ts.map +1 -0
  24. package/dist/composites/tela-inspect.js +126 -0
  25. package/dist/composites/tela-inspect.js.map +1 -0
  26. package/dist/docs-parse.d.ts +18 -0
  27. package/dist/docs-parse.d.ts.map +1 -1
  28. package/dist/docs-parse.js +79 -1
  29. package/dist/docs-parse.js.map +1 -1
  30. package/dist/docs.d.ts +10 -0
  31. package/dist/docs.d.ts.map +1 -1
  32. package/dist/docs.js +223 -36
  33. package/dist/docs.js.map +1 -1
  34. package/dist/http-server.d.ts.map +1 -1
  35. package/dist/http-server.js +5 -1
  36. package/dist/http-server.js.map +1 -1
  37. package/dist/server.d.ts +2 -0
  38. package/dist/server.d.ts.map +1 -1
  39. package/dist/server.js +79 -18
  40. package/dist/server.js.map +1 -1
  41. package/dist/tela-parse.d.ts +114 -0
  42. package/dist/tela-parse.d.ts.map +1 -0
  43. package/dist/tela-parse.js +242 -0
  44. package/dist/tela-parse.js.map +1 -0
  45. package/dist/tool-descriptions.d.ts +3 -1
  46. package/dist/tool-descriptions.d.ts.map +1 -1
  47. package/dist/tool-descriptions.js +21 -2
  48. package/dist/tool-descriptions.js.map +1 -1
  49. 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 + 7 composite tools, with a bundled documentation index spanning derod, tela, hologram, and deropay.
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
  [![MCP Registry](https://img.shields.io/badge/MCP-io.github.DHEBP%2Fdero--mcp--server-blue)](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.DHEBP/dero-mcp-server)
6
6
  [![CI](https://github.com/DHEBP/dero-mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/DHEBP/dero-mcp-server/actions/workflows/ci.yml)
7
7
  [![dero-mcp-server MCP server](https://glama.ai/mcp/servers/DHEBP/dero-mcp-server/badges/card.svg)](https://glama.ai/mcp/servers/DHEBP/dero-mcp-server)
8
8
 
9
- **Registry listing:** `io.github.DHEBP/dero-mcp-server` · **Version:** `0.3.0` · **Transports:** `stdio` (default, npm package) · `streamable-http` (`--http`, for self-hosting)
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 18+** ([install](https://nodejs.org)) — verify with `node --version`.
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 **18+**
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 (20):** daemon read/analysis methods + docs retrieval (`dero_docs_search`, `dero_docs_get_page`, `dero_docs_list`)
273
- - **Resources (3):** `dero://mcp/server-info`, `dero://mcp/safety-boundary`, `dero://mcp/example-flows`
274
- - **Prompts (3):** `network_health_check`, `inspect_smart_contract`, `trace_transaction`
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.3.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 7 composite tools and when to use each
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