@mekareteriker/opencode-mcp 1.10.2-mekareteriker.0

package/dist/tools/file.js

@@ -0,0 +1,153 @@
+import { z } from "zod";
+import { toolJson, toolError, toolResult, directoryParam, readOnly } from "../helpers.js";
+export function registerFileTools(server, client) {
+    server.tool("opencode_find_text", "Search for text patterns in project files (regex supported). Returns file paths, line numbers, and matching lines.", {
+        pattern: z
+            .string()
+            .describe("Text or regex pattern to search for in files"),
+        directory: directoryParam,
+    }, readOnly, async ({ pattern, directory }) => {
+        try {
+            const raw = await client.get("/find", { pattern }, directory);
+            const results = Array.isArray(raw) ? raw : [];
+            if (results.length === 0) {
+                return toolResult(`No matches found for pattern: ${pattern}`);
+            }
+            const formatted = results.map((r) => {
+                // The API returns path as {text: "file.ts"} and lines as {text: "content\n"}
+                const rawPath = r.path ?? r.file ?? r.name ?? "";
+                const filePath = typeof rawPath === "string"
+                    ? rawPath
+                    : rawPath?.text ?? rawPath?.path ?? rawPath?.name ?? String(rawPath);
+                const lineNum = r.line_number ?? r.lineNumber ?? r.line ?? "?";
+                const rawLines = r.lines ?? r.text ?? r.content ?? "";
+                const lineText = typeof rawLines === "string"
+                    ? rawLines.trim()
+                    : rawLines?.text != null
+                        ? String(rawLines.text).trim()
+                        : JSON.stringify(rawLines);
+                return `${filePath}:${lineNum}  ${lineText}`;
+            }).join("\n");
+            return toolResult(`${results.length} match(es):\n\n${formatted}`);
+        }
+        catch (e) {
+            return toolError(e);
+        }
+    });
+    server.tool("opencode_find_file", "Find files and directories by name (fuzzy match)", {
+        query: z.string().describe("Search string for file/directory names"),
+        type: z
+            .enum(["file", "directory"])
+            .optional()
+            .describe("Limit results to 'file' or 'directory'"),
+        searchDirectory: z
+            .string()
+            .optional()
+            .describe("Override the project root for the search"),
+        limit: z
+            .number()
+            .optional()
+            .describe("Max number of results (1-200)"),
+        directory: directoryParam,
+    }, readOnly, async ({ query, type, searchDirectory, limit, directory }) => {
+        try {
+            const q = { query };
+            if (type)
+                q.type = type;
+            if (searchDirectory)
+                q.directory = searchDirectory;
+            if (limit !== undefined)
+                q.limit = String(limit);
+            const files = (await client.get("/find/file", q, directory));
+            if (!files || files.length === 0) {
+                return toolResult(`No files found matching: ${query}`);
+            }
+            return toolResult(files.join("\n"));
+        }
+        catch (e) {
+            return toolError(e);
+        }
+    });
+    server.tool("opencode_find_symbol", "Find workspace symbols by name (functions, classes, variables, etc.)", {
+        query: z.string().describe("Symbol name to search for"),
+        directory: directoryParam,
+    }, readOnly, async ({ query, directory }) => {
+        try {
+            const raw = await client.get("/find/symbol", { query }, directory);
+            const symbols = Array.isArray(raw) ? raw : [];
+            if (symbols.length === 0) {
+                return toolResult(`No symbols found matching: ${query}`);
+            }
+            const lines = symbols.map((s) => {
+                const name = s.name ?? s.symbol ?? "?";
+                const kind = s.kind ? ` (${s.kind})` : "";
+                const loc = s.location ?? s.path ?? s.file ?? "";
+                const line = s.line ?? s.lineNumber ?? "";
+                const locStr = loc ? ` — ${loc}${line ? `:${line}` : ""}` : "";
+                return `- ${name}${kind}${locStr}`;
+            });
+            return toolResult(`${symbols.length} symbol(s) matching "${query}":\n\n${lines.join("\n")}`);
+        }
+        catch (e) {
+            return toolError(e);
+        }
+    });
+    server.tool("opencode_file_list", "List files and directories at a path", {
+        path: z
+            .string()
+            .optional()
+            .describe("Path to list (defaults to project root)"),
+        directory: directoryParam,
+    }, readOnly, async ({ path, directory }) => {
+        try {
+            const q = { path: path || "." };
+            const nodes = (await client.get("/file", q, directory));
+            if (!nodes || nodes.length === 0) {
+                return toolResult("Empty directory.");
+            }
+            const formatted = nodes.map((n) => {
+                const type = n.type === "directory" ? "[DIR]" : "     ";
+                return `${type} ${n.name ?? n.path ?? "?"}`;
+            }).join("\n");
+            return toolResult(formatted);
+        }
+        catch (e) {
+            return toolError(e);
+        }
+    });
+    server.tool("opencode_file_read", "Read the content of a file", {
+        path: z.string().describe("File path to read"),
+        directory: directoryParam,
+    }, readOnly, async ({ path, directory }) => {
+        try {
+            const result = (await client.get("/file/content", { path }, directory));
+            if (typeof result.content === "string") {
+                return toolResult(`File: ${path}\n\n${result.content}`);
+            }
+            return toolJson(result);
+        }
+        catch (e) {
+            return toolError(e);
+        }
+    });
+    server.tool("opencode_file_status", "Get status for tracked files (VCS changes: modified, added, deleted, etc.)", {
+        directory: directoryParam,
+    }, readOnly, async ({ directory }) => {
+        try {
+            const files = (await client.get("/file/status", undefined, directory));
+            if (!files || files.length === 0) {
+                return toolResult("No tracked file changes.");
+            }
+            const formatted = files.map((f) => {
+                const status = f.status ?? f.type ?? "?";
+                const path = f.path ?? f.file ?? "?";
+                return `[${status}] ${path}`;
+            }).join("\n");
+            return toolResult(formatted);
+        }
+        catch (e) {
+            return toolError(e);
+        }
+    });
+}
+//# sourceMappingURL=file.js.map

package/dist/tools/file.js.map

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

package/dist/tools/global.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { OpenCodeClient } from "../client.js";
+export declare function registerGlobalTools(server: McpServer, client: OpenCodeClient): void;

package/dist/tools/global.js

@@ -0,0 +1,17 @@
+import { toolResult, toolError, directoryParam, readOnly } from "../helpers.js";
+export function registerGlobalTools(server, client) {
+    server.tool("opencode_health", "Check server health and version", {
+        directory: directoryParam,
+    }, readOnly, async ({ directory }) => {
+        try {
+            const raw = await client.get("/global/health", undefined, directory);
+            const status = raw.healthy ? "healthy" : "unhealthy";
+            const version = raw.version ?? "unknown";
+            return toolResult(`Status: ${status}\nVersion: ${version}`);
+        }
+        catch (e) {
+            return toolError(e);
+        }
+    });
+}
+//# sourceMappingURL=global.js.map

package/dist/tools/global.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global.js","sourceRoot":"","sources":["../../src/tools/global.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEhF,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,MAAsB;IAC3E,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,iCAAiC,EACjC;QACE,SAAS,EAAE,cAAc;KAC1B,EACD,QAAQ,EACR,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE,SAAS,EAAE,SAAS,CAA4B,CAAC;YAChG,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC;YACrD,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,SAAS,CAAC;YACzC,OAAO,UAAU,CAAC,WAAW,MAAM,cAAc,OAAO,EAAE,CAAC,CAAC;QAC9D,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/message.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { OpenCodeClient } from "../client.js";
+export declare function registerMessageTools(server: McpServer, client: OpenCodeClient): void;

package/dist/tools/message.js

@@ -0,0 +1,169 @@
+import { z } from "zod";
+import { toolResult, toolError, formatMessageResponse, analyzeMessageResponse, formatMessageList, applyModelDefaults, directoryParam, } from "../helpers.js";
+export function registerMessageTools(server, client) {
+    server.tool("opencode_message_list", "List all messages in a session with formatted output showing roles and content", {
+        sessionId: z.string().describe("Session ID"),
+        limit: z
+            .number()
+            .optional()
+            .describe("Maximum number of messages to return"),
+        directory: directoryParam,
+    }, async ({ sessionId, limit, directory }) => {
+        try {
+            const query = {};
+            if (limit !== undefined)
+                query.limit = String(limit);
+            const messages = await client.get(`/session/${sessionId}/message`, query, directory);
+            return toolResult(formatMessageList(messages));
+        }
+        catch (e) {
+            return toolError(e);
+        }
+    });
+    server.tool("opencode_message_get", "Get details of a specific message in a session", {
+        sessionId: z.string().describe("Session ID"),
+        messageId: z.string().describe("Message ID"),
+        directory: directoryParam,
+    }, async ({ sessionId, messageId, directory }) => {
+        try {
+            const msg = await client.get(`/session/${sessionId}/message/${messageId}`, undefined, directory);
+            return toolResult(formatMessageResponse(msg));
+        }
+        catch (e) {
+            return toolError(e);
+        }
+    });
+    server.tool("opencode_message_send", "Send a prompt message to a session and wait for the AI response. Use parts to send text, and optionally specify a model.", {
+        sessionId: z.string().describe("Session ID"),
+        text: z.string().describe("The text message to send"),
+        providerID: z
+            .string()
+            .optional()
+            .describe("Provider ID (e.g. 'anthropic')"),
+        modelID: z
+            .string()
+            .optional()
+            .describe("Model ID (e.g. 'claude-3-5-sonnet-20241022')"),
+        variant: z.string().optional().describe("Model variant (e.g. 'fast', 'smart')"),
+        agent: z.string().optional().describe("Agent to use"),
+        noReply: z
+            .boolean()
+            .optional()
+            .describe("If true, inject context without triggering AI response (useful for plugins)"),
+        system: z.string().optional().describe("System prompt override"),
+        directory: directoryParam,
+    }, async ({ sessionId, text, providerID, modelID, variant, agent, noReply, system, directory, }) => {
+        try {
+            const body = {
+                parts: [{ type: "text", text }],
+            };
+            const model = applyModelDefaults(providerID, modelID, variant);
+            if (model)
+                body.model = model;
+            if (agent)
+                body.agent = agent;
+            if (noReply !== undefined)
+                body.noReply = noReply;
+            if (system)
+                body.system = system;
+            const response = await client.post(`/session/${sessionId}/message`, body, { directory });
+            const analysis = analyzeMessageResponse(response);
+            const formatted = formatMessageResponse(response);
+            const parts = [];
+            if (formatted)
+                parts.push(formatted);
+            if (analysis.warning) {
+                parts.push(`\n--- WARNING ---\n${analysis.warning}`);
+            }
+            return toolResult(parts.join("\n\n") || "Empty response.", analysis.hasError);
+        }
+        catch (e) {
+            return toolError(e);
+        }
+    });
+    server.tool("opencode_message_send_async", "Send a prompt message asynchronously (fire-and-forget, does not wait for response). Use opencode_wait to poll for completion.", {
+        sessionId: z.string().describe("Session ID"),
+        text: z.string().describe("The text message to send"),
+        providerID: z
+            .string()
+            .optional()
+            .describe("Provider ID (e.g. 'anthropic')"),
+        modelID: z
+            .string()
+            .optional()
+            .describe("Model ID (e.g. 'claude-3-5-sonnet-20241022')"),
+        variant: z.string().optional().describe("Model variant (e.g. 'fast', 'smart')"),
+        agent: z.string().optional().describe("Agent to use"),
+        directory: directoryParam,
+    }, async ({ sessionId, text, providerID, modelID, variant, agent, directory }) => {
+        try {
+            const body = {
+                parts: [{ type: "text", text }],
+            };
+            const model = applyModelDefaults(providerID, modelID, variant);
+            if (model)
+                body.model = model;
+            if (agent)
+                body.agent = agent;
+            await client.post(`/session/${sessionId}/prompt_async`, body, { directory });
+            return toolResult("Message sent asynchronously. Use opencode_wait or opencode_message_list to check for responses.");
+        }
+        catch (e) {
+            return toolError(e);
+        }
+    });
+    server.tool("opencode_command_execute", "Execute a slash command in a session (e.g. /init, /undo, /redo)", {
+        sessionId: z.string().describe("Session ID"),
+        command: z
+            .string()
+            .describe("The slash command to execute (e.g. 'init', 'undo')"),
+        arguments: z
+            .string()
+            .optional()
+            .describe("Arguments for the command"),
+        agent: z.string().optional().describe("Agent to use"),
+        providerID: z.string().optional().describe("Provider ID"),
+        modelID: z.string().optional().describe("Model ID"),
+        variant: z.string().optional().describe("Model variant"),
+        directory: directoryParam,
+    }, async ({ sessionId, command, arguments: args, agent, providerID, modelID, variant, directory, }) => {
+        try {
+            const body = {
+                command,
+                arguments: args ?? "",
+            };
+            if (agent)
+                body.agent = agent;
+            const cmdModel = applyModelDefaults(providerID, modelID, variant);
+            if (cmdModel)
+                body.model = cmdModel;
+            const result = await client.post(`/session/${sessionId}/command`, body, { directory });
+            return toolResult(formatMessageResponse(result));
+        }
+        catch (e) {
+            return toolError(e);
+        }
+    });
+    server.tool("opencode_shell_execute", "Run a shell command through the opencode session", {
+        sessionId: z.string().describe("Session ID"),
+        command: z.string().describe("Shell command to execute"),
+        agent: z.string().describe("Agent to use for the shell command"),
+        providerID: z.string().optional().describe("Provider ID"),
+        modelID: z.string().optional().describe("Model ID"),
+        variant: z.string().optional().describe("Model variant"),
+        directory: directoryParam,
+    }, async ({ sessionId, command, agent, providerID, modelID, variant, directory }) => {
+        try {
+            const body = { command, agent };
+            const shellModel = applyModelDefaults(providerID, modelID, variant);
+            if (shellModel)
+                body.model = shellModel;
+            const result = await client.post(`/session/${sessionId}/shell`, body, { directory });
+            return toolResult(formatMessageResponse(result));
+        }
+        catch (e) {
+            return toolError(e);
+        }
+    });
+}
+//# sourceMappingURL=message.js.map

package/dist/tools/message.js.map

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

package/dist/tools/misc.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { OpenCodeClient } from "../client.js";
+export declare function registerMiscTools(server: McpServer, client: OpenCodeClient): void;