dexe-mcp 0.1.0

package/dist/tools/introspect.js

@@ -0,0 +1,312 @@
+import { z } from "zod";
+import { readFileSync, existsSync } from "node:fs";
+import { join, isAbsolute } from "node:path";
+import { ArtifactsMissingError } from "../artifacts.js";
+export function registerIntrospectTools(server, ctx) {
+    registerListContracts(server, ctx);
+    registerGetAbi(server, ctx);
+    registerGetSelectors(server, ctx);
+    registerFindSelector(server, ctx);
+    registerGetNatspec(server, ctx);
+    registerGetSource(server, ctx);
+}
+// All tools here wrap their body in this guard so users get one consistent
+// "run dexe_compile first" message instead of a raw stack.
+async function guarded(ctx, fn) {
+    try {
+        ctx.artifacts.requireArtifactsExist();
+        return { ok: true, value: await fn() };
+    }
+    catch (err) {
+        if (err instanceof ArtifactsMissingError) {
+            return { ok: false, error: err.message };
+        }
+        return { ok: false, error: err instanceof Error ? err.message : String(err) };
+    }
+}
+function errorResult(message) {
+    return {
+        content: [{ type: "text", text: message }],
+        isError: true,
+    };
+}
+// ---------- dexe_list_contracts ----------
+function registerListContracts(server, ctx) {
+    server.registerTool("dexe_list_contracts", {
+        title: "List compiled contracts",
+        description: "Enumerates all compiled DeXe-Protocol contracts. Filter by substring match on name and/or kind (contract/interface/library). Requires dexe_compile to have run at least once.",
+        inputSchema: {
+            filter: z.string().optional().describe("Case-insensitive substring match on contract name"),
+            kind: z.enum(["contract", "interface", "library"]).optional(),
+        },
+        outputSchema: {
+            count: z.number(),
+            contracts: z.array(z.object({
+                name: z.string(),
+                sourceName: z.string(),
+                kind: z.enum(["contract", "interface", "library"]),
+            })),
+        },
+    }, async (args) => {
+        const res = await guarded(ctx, () => ctx.artifacts.list(args));
+        if (!res.ok)
+            return errorResult(res.error);
+        const records = res.value;
+        const structured = {
+            count: records.length,
+            contracts: records
+                .map((r) => ({ name: r.contractName, sourceName: r.sourceName, kind: r.kind }))
+                .sort((a, b) => a.name.localeCompare(b.name)),
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `${structured.count} contract(s):\n${structured.contracts
+                        .map((c) => `  [${c.kind.padEnd(9)}] ${c.name}  (${c.sourceName})`)
+                        .join("\n")}`,
+                },
+            ],
+            structuredContent: structured,
+        };
+    });
+}
+// ---------- dexe_get_abi ----------
+function registerGetAbi(server, ctx) {
+    server.registerTool("dexe_get_abi", {
+        title: "Get contract ABI",
+        description: "Returns the ABI JSON for a compiled contract by name.",
+        inputSchema: {
+            contract: z.string().describe("Contract name, e.g. 'GovPool'"),
+        },
+        outputSchema: {
+            contract: z.string(),
+            sourceName: z.string(),
+            abi: z.array(z.unknown()),
+        },
+    }, async ({ contract }) => {
+        const res = await guarded(ctx, () => ctx.artifacts.getOne(contract));
+        if (!res.ok)
+            return errorResult(res.error);
+        const r = res.value;
+        const structured = {
+            contract: r.contractName,
+            sourceName: r.sourceName,
+            abi: r.abi,
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `ABI for ${r.contractName} (${r.sourceName}) — ${structured.abi.length} entries`,
+                },
+            ],
+            structuredContent: structured,
+        };
+    });
+}
+// ---------- dexe_get_selectors ----------
+function registerGetSelectors(server, ctx) {
+    server.registerTool("dexe_get_selectors", {
+        title: "Get contract selectors",
+        description: "Returns all function selectors, event topic hashes, and error selectors for a contract.",
+        inputSchema: {
+            contract: z.string(),
+        },
+        outputSchema: {
+            contract: z.string(),
+            count: z.number(),
+            selectors: z.array(z.object({
+                signature: z.string(),
+                selector: z.string(),
+                kind: z.enum(["function", "event", "error"]),
+            })),
+        },
+    }, async ({ contract }) => {
+        const res = await guarded(ctx, () => ctx.selectors.forContract(contract));
+        if (!res.ok)
+            return errorResult(res.error);
+        const hits = res.value;
+        const structured = {
+            contract,
+            count: hits.length,
+            selectors: hits.map((h) => ({
+                signature: h.signature,
+                selector: h.selector,
+                kind: h.kind,
+            })),
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `${structured.count} selector(s) for ${contract}:\n${structured.selectors
+                        .slice(0, 50)
+                        .map((s) => `  ${s.selector}  [${s.kind}]  ${s.signature}`)
+                        .join("\n")}${structured.count > 50 ? `\n  … ${structured.count - 50} more` : ""}`,
+                },
+            ],
+            structuredContent: structured,
+        };
+    });
+}
+// ---------- dexe_find_selector ----------
+function registerFindSelector(server, ctx) {
+    server.registerTool("dexe_find_selector", {
+        title: "Reverse selector lookup",
+        description: "Given a 4-byte selector (function/error, '0x…') or 32-byte event topic hash, returns all matching contracts and signatures across the compiled codebase. Supports collisions.",
+        inputSchema: {
+            selector: z.string().regex(/^0x[0-9a-fA-F]+$/, "Must be a 0x-prefixed hex string"),
+        },
+        outputSchema: {
+            selector: z.string(),
+            count: z.number(),
+            hits: z.array(z.object({
+                contract: z.string(),
+                sourceName: z.string(),
+                signature: z.string(),
+                kind: z.enum(["function", "event", "error"]),
+            })),
+        },
+    }, async ({ selector }) => {
+        const res = await guarded(ctx, () => ctx.selectors.find(selector));
+        if (!res.ok)
+            return errorResult(res.error);
+        const hits = res.value;
+        const structured = {
+            selector,
+            count: hits.length,
+            hits: hits.map((h) => ({
+                contract: h.contract,
+                sourceName: h.sourceName,
+                signature: h.signature,
+                kind: h.kind,
+            })),
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: hits.length === 0
+                        ? `No matches for ${selector}`
+                        : `${hits.length} match(es) for ${selector}:\n${structured.hits
+                            .map((h) => `  ${h.contract}.${h.signature}  [${h.kind}]`)
+                            .join("\n")}`,
+                },
+            ],
+            structuredContent: structured,
+        };
+    });
+}
+// ---------- dexe_get_natspec ----------
+function registerGetNatspec(server, ctx) {
+    server.registerTool("dexe_get_natspec", {
+        title: "Get NatSpec docs",
+        description: "Reads devdoc/userdoc for a contract from build-info. Optionally scope to a single member (function/event signature or name).",
+        inputSchema: {
+            contract: z.string(),
+            member: z.string().optional().describe("Function/event name or full signature"),
+        },
+        outputSchema: {
+            contract: z.string(),
+            devdoc: z.unknown().optional(),
+            userdoc: z.unknown().optional(),
+        },
+    }, async ({ contract, member }) => {
+        const res = await guarded(ctx, () => {
+            const record = ctx.artifacts.getOne(contract);
+            const info = ctx.artifacts.loadBuildInfoFor(record);
+            if (!info) {
+                throw new Error(`No build-info found for ${contract}. devdoc/userdoc may be disabled in the protocol's hardhat config outputSelection.`);
+            }
+            const devdoc = (info.devdoc ?? null);
+            const userdoc = (info.userdoc ?? null);
+            if (member) {
+                return {
+                    devdoc: devdoc?.methods ? filterMember(devdoc.methods, member) : undefined,
+                    userdoc: userdoc?.methods ? filterMember(userdoc.methods, member) : undefined,
+                };
+            }
+            return { devdoc: devdoc ?? undefined, userdoc: userdoc ?? undefined };
+        });
+        if (!res.ok)
+            return errorResult(res.error);
+        const structured = { contract, ...res.value };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `NatSpec for ${contract}${member ? `::${member}` : ""}:\n${JSON.stringify({ devdoc: structured.devdoc, userdoc: structured.userdoc }, null, 2).slice(0, 4000)}`,
+                },
+            ],
+            structuredContent: structured,
+        };
+    });
+}
+function filterMember(methods, member) {
+    const m = member.toLowerCase();
+    const out = {};
+    for (const [key, value] of Object.entries(methods)) {
+        if (key.toLowerCase().includes(m))
+            out[key] = value;
+    }
+    return out;
+}
+// ---------- dexe_get_source ----------
+function registerGetSource(server, ctx) {
+    server.registerTool("dexe_get_source", {
+        title: "Get contract source",
+        description: "Returns the source file path for a contract. Optionally slices around a symbol (function/event name) using a naive regex scan — AST-based extraction is a future enhancement.",
+        inputSchema: {
+            contract: z.string(),
+            symbol: z.string().optional(),
+        },
+        outputSchema: {
+            contract: z.string(),
+            sourceName: z.string(),
+            sourcePath: z.string(),
+            snippet: z.string().optional(),
+            snippetStartLine: z.number().optional(),
+        },
+    }, async ({ contract, symbol }) => {
+        const res = await guarded(ctx, () => {
+            const record = ctx.artifacts.getOne(contract);
+            const sourcePath = isAbsolute(record.sourceName)
+                ? record.sourceName
+                : join(ctx.config.protocolPath, record.sourceName);
+            let snippet;
+            let snippetStartLine;
+            if (symbol && existsSync(sourcePath)) {
+                const src = readFileSync(sourcePath, "utf8");
+                const lines = src.split(/\r?\n/);
+                const pattern = new RegExp(`\\b(function|event|error|modifier)\\s+${escapeRegExp(symbol)}\\b`);
+                const idx = lines.findIndex((l) => pattern.test(l));
+                if (idx >= 0) {
+                    const start = Math.max(0, idx - 2);
+                    const end = Math.min(lines.length, idx + 30);
+                    snippet = lines.slice(start, end).join("\n");
+                    snippetStartLine = start + 1;
+                }
+            }
+            return { sourceName: record.sourceName, sourcePath, snippet, snippetStartLine };
+        });
+        if (!res.ok)
+            return errorResult(res.error);
+        const structured = { contract, ...res.value };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: structured.snippet
+                        ? `${structured.sourcePath}:${structured.snippetStartLine}\n\n${structured.snippet}`
+                        : structured.sourcePath,
+                },
+            ],
+            structuredContent: structured,
+        };
+    });
+}
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=introspect.js.map

package/dist/tools/introspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspect.js","sourceRoot":"","sources":["../../src/tools/introspect.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "dexe-mcp",
+  "version": "0.1.0",
+  "description": "MCP server wrapping DeXe Protocol for Claude Code dev tooling (build/test, contract introspection, governance-domain tools)",
+  "type": "module",
+  "license": "MIT",
+  "author": "Edward Arinin <edward.arinin@gmail.com>",
+  "homepage": "https://github.com/edward-arinin-web-dev/dexe-mcp#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/edward-arinin-web-dev/dexe-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/edward-arinin-web-dev/dexe-mcp/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "claude-code",
+    "hardhat",
+    "solidity",
+    "ethereum",
+    "dexe",
+    "dao",
+    "governance",
+    "smart-contracts",
+    "dev-tools"
+  ],
+  "bin": {
+    "dexe-mcp": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "FUTURE.md",
+    "PLAN.md",
+    ".mcp.example.json"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run typecheck && npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "ethers": "^6.13.0",
+    "execa": "^9.5.0",
+    "p-limit": "^6.2.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}