npm - general-coding-tools-mcp - Versions diffs - 1.0.2 → 1.0.3 - Mend

general-coding-tools-mcp 1.0.2 → 1.0.3

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 (3) hide show

package/dist/index.d.ts CHANGED Viewed

@@ -3,7 +3,4 @@
  * General Coding Tools MCP Server
  * Exposes skills and subagents as MCP resources and tools for use in Cursor, Claude, and Smithery.
  */
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-/** Returns a server instance for Smithery capability scanning. Loads real content when dist/content.json exists (e.g. when scan runs from project dir), otherwise uses empty content so the scan still succeeds. */
-export declare function createSandboxServer(): McpServer;
-export default createSandboxServer;
+export {};

package/dist/index.js CHANGED Viewed

@@ -10,17 +10,7 @@ import { readFileSync, existsSync } from "fs";
 import { createHash } from "crypto";
 import { fileURLToPath } from "url";
 import { dirname, join } from "path";
-// Support both ESM (import.meta.url) and CJS bundles (e.g. Smithery stdio scan) where it may be undefined
-function getContentDir() {
-    if (typeof import.meta !== "undefined" && import.meta.url) {
-        return dirname(fileURLToPath(import.meta.url));
-    }
-    if (typeof process !== "undefined" && process.cwd) {
-        return join(process.cwd(), "dist");
-    }
-    return ".";
-}
-const __dirname = getContentDir();
+const __dirname = dirname(fileURLToPath(import.meta.url));
 /** Escape HTML special chars so embedded user input cannot inject script if client renders as HTML. */
 function escapeForEmbedding(s) {
     return s
@@ -30,18 +20,12 @@ function escapeForEmbedding(s) {
         .replace(/"/g, "&quot;")
         .replace(/'/g, "&#39;");
 }
-const EMPTY_CONTENT = {
-    skills: [],
-    subagents: [],
-    content: { skills: {}, subagents: {} },
-};
 // Load bundled content (generated by scripts/bundle-content.cjs); verify integrity via SHA-256
 function loadContent() {
     const contentPath = join(__dirname, "content.json");
     const hashPath = join(__dirname, "content.json.sha256");
     if (!existsSync(contentPath)) {
-        // Allow running without content.json for capability scanning (e.g. Smithery build)
-        return EMPTY_CONTENT;
+        throw new Error("content.json not found. Run 'npm run build' from mcp-server to bundle Skills and Subagents.");
     }
     const raw = readFileSync(contentPath, "utf8");
     if (existsSync(hashPath)) {
@@ -53,161 +37,150 @@ function loadContent() {
     }
     return JSON.parse(raw);
 }
+const DATA = loadContent();
 const RESOURCE_PREFIX = "general-coding-tools-mcp://";
-/** Create an MCP server with the given content (or load from disk if not provided). Used for normal run and for Smithery createSandboxServer. */
-function createServer(contentOverride) {
-    const DATA = contentOverride ?? loadContent();
-    const server = new McpServer({
-        name: "general-coding-tools-mcp",
-        version: "1.0.0",
+const server = new McpServer({
+    name: "general-coding-tools-mcp",
+    version: "1.0.0",
+});
+// --- Resources: one per skill, skill/reference, and subagent ---
+for (const s of DATA.skills) {
+    const uri = `${RESOURCE_PREFIX}skill/${s.id}`;
+    server.registerResource(`skill-${s.id}`, uri, {
+        title: `Skill: ${s.name}`,
+        description: `General Coding Tools skill: ${s.name}`,
+        mimeType: "text/markdown",
+    }, async () => {
+        const entry = DATA.content.skills[s.name];
+        return {
+            contents: [{ uri, mimeType: "text/markdown", text: entry.content }],
+        };
     });
-    // --- Resources: one per skill, skill/reference, and subagent ---
-    for (const s of DATA.skills) {
-        const uri = `${RESOURCE_PREFIX}skill/${s.id}`;
-        server.registerResource(`skill-${s.id}`, uri, {
-            title: `Skill: ${s.name}`,
-            description: `General Coding Tools skill: ${s.name}`,
+    if (DATA.content.skills[s.name]?.reference) {
+        const refUri = `${RESOURCE_PREFIX}skill/${s.id}/reference`;
+        server.registerResource(`skill-${s.id}-reference`, refUri, {
+            title: `Skill reference: ${s.name}`,
+            description: `Reference material for skill ${s.name}`,
             mimeType: "text/markdown",
         }, async () => {
             const entry = DATA.content.skills[s.name];
             return {
-                contents: [{ uri, mimeType: "text/markdown", text: entry.content }],
-            };
-        });
-        if (DATA.content.skills[s.name]?.reference) {
-            const refUri = `${RESOURCE_PREFIX}skill/${s.id}/reference`;
-            server.registerResource(`skill-${s.id}-reference`, refUri, {
-                title: `Skill reference: ${s.name}`,
-                description: `Reference material for skill ${s.name}`,
-                mimeType: "text/markdown",
-            }, async () => {
-                const entry = DATA.content.skills[s.name];
-                return {
-                    contents: [{ uri: refUri, mimeType: "text/markdown", text: entry.reference }],
-                };
-            });
-        }
-    }
-    for (const a of DATA.subagents) {
-        const uri = `${RESOURCE_PREFIX}subagent/${a.id}`;
-        server.registerResource(`subagent-${a.id}`, uri, {
-            title: `Subagent: ${a.name}`,
-            description: `General Coding Tools subagent: ${a.name}`,
-            mimeType: "text/markdown",
-        }, async () => {
-            const entry = DATA.content.subagents[a.name];
-            return {
-                contents: [{ uri, mimeType: "text/markdown", text: entry.content }],
+                contents: [{ uri: refUri, mimeType: "text/markdown", text: entry.reference }],
             };
         });
     }
-    // --- Tools ---
-    server.registerTool("list_skills", {
-        title: "List skills",
-        description: "List all available General Coding Tools skills (e.g. systematic-debugging, correctness-audit).",
-        inputSchema: z.object({}),
-    }, async () => {
-        const list = DATA.skills.map((s) => ({ id: s.id, name: s.name, hasReference: s.hasReference }));
-        return { content: [{ type: "text", text: JSON.stringify(list, null, 2) }] };
-    });
-    server.registerTool("list_subagents", {
-        title: "List subagents",
-        description: "List all available General Coding Tools subagents (e.g. deep-research, update-docs, verifier).",
-        inputSchema: z.object({}),
+}
+for (const a of DATA.subagents) {
+    const uri = `${RESOURCE_PREFIX}subagent/${a.id}`;
+    server.registerResource(`subagent-${a.id}`, uri, {
+        title: `Subagent: ${a.name}`,
+        description: `General Coding Tools subagent: ${a.name}`,
+        mimeType: "text/markdown",
     }, async () => {
-        const list = DATA.subagents.map((a) => ({ id: a.id, name: a.name }));
-        return { content: [{ type: "text", text: JSON.stringify(list, null, 2) }] };
-    });
-    server.registerTool("get_skill", {
-        title: "Get skill content",
-        description: "Get the full content of a skill by name (id). Use list_skills to see available names.",
-        inputSchema: z.object({
-            name: z.string().max(200).describe("Skill id (e.g. systematic-debugging, correctness-audit)"),
-            include_reference: z.boolean().optional().default(false).describe("Include REFERENCE.md if present"),
-        }),
-    }, async ({ name, include_reference }) => {
-        const skill = DATA.skills.find((s) => s.id === name || s.name === name);
-        if (!skill) {
-            return {
-                content: [{ type: "text", text: `Unknown skill: ${escapeForEmbedding(name)}. Use list_skills to see available skills.` }],
-                isError: true,
-            };
-        }
-        const entry = DATA.content.skills[skill.name];
-        let text = entry.content;
-        if (include_reference && entry.reference) {
-            text += "\n\n---\n\n## Reference\n\n" + entry.reference;
-        }
-        return { content: [{ type: "text", text }] };
+        const entry = DATA.content.subagents[a.name];
+        return {
+            contents: [{ uri, mimeType: "text/markdown", text: entry.content }],
+        };
     });
-    server.registerTool("get_subagent", {
-        title: "Get subagent content",
-        description: "Get the full content of a subagent by name (id). Use list_subagents to see available names.",
-        inputSchema: z.object({
-            name: z.string().max(200).describe("Subagent id (e.g. deep-research, update-docs, verifier)"),
-        }),
-    }, async ({ name }) => {
-        const subagent = DATA.subagents.find((a) => a.id === name || a.name === name);
-        if (!subagent) {
-            return {
-                content: [{ type: "text", text: `Unknown subagent: ${escapeForEmbedding(name)}. Use list_subagents to see available subagents.` }],
-                isError: true,
-            };
-        }
-        const entry = DATA.content.subagents[subagent.name];
-        return { content: [{ type: "text", text: entry.content }] };
-    });
-    // --- Prompts: apply skill / subagent with user message ---
-    for (const s of DATA.skills) {
-        const promptName = `apply_skill_${s.id.replace(/-/g, "_")}`;
-        server.registerPrompt(promptName, {
-            title: `Apply skill: ${s.name}`,
-            description: `Apply the "${s.name}" skill. Use when the user wants to follow this skill's process.`,
-            argsSchema: {
-                user_message: z.string().describe("What the user asked or the current task"),
-            },
-        }, async ({ user_message }) => {
-            const entry = DATA.content.skills[s.name];
-            const safeMessage = escapeForEmbedding(String(user_message ?? "(no message provided)"));
-            const text = `I will follow the **${s.name}** skill.\n\n---\n\n${entry.content}\n\n---\n\nUser request: ${safeMessage}`;
-            return {
-                messages: [
-                    { role: "user", content: { type: "text", text: String(user_message ?? "") } },
-                    { role: "assistant", content: { type: "text", text } },
-                ],
-            };
-        });
+}
+// --- Tools ---
+server.registerTool("list_skills", {
+    title: "List skills",
+    description: "List all available General Coding Tools skills (e.g. systematic-debugging, correctness-audit).",
+    inputSchema: z.object({}),
+}, async () => {
+    const list = DATA.skills.map((s) => ({ id: s.id, name: s.name, hasReference: s.hasReference }));
+    return { content: [{ type: "text", text: JSON.stringify(list, null, 2) }] };
+});
+server.registerTool("list_subagents", {
+    title: "List subagents",
+    description: "List all available General Coding Tools subagents (e.g. deep-research, update-docs, verifier).",
+    inputSchema: z.object({}),
+}, async () => {
+    const list = DATA.subagents.map((a) => ({ id: a.id, name: a.name }));
+    return { content: [{ type: "text", text: JSON.stringify(list, null, 2) }] };
+});
+server.registerTool("get_skill", {
+    title: "Get skill content",
+    description: "Get the full content of a skill by name (id). Use list_skills to see available names.",
+    inputSchema: z.object({
+        name: z.string().max(200).describe("Skill id (e.g. systematic-debugging, correctness-audit)"),
+        include_reference: z.boolean().optional().default(false).describe("Include REFERENCE.md if present"),
+    }),
+}, async ({ name, include_reference }) => {
+    const skill = DATA.skills.find((s) => s.id === name || s.name === name);
+    if (!skill) {
+        return {
+            content: [{ type: "text", text: `Unknown skill: ${escapeForEmbedding(name)}. Use list_skills to see available skills.` }],
+            isError: true,
+        };
     }
-    for (const a of DATA.subagents) {
-        const promptName = `apply_subagent_${a.id.replace(/-/g, "_")}`;
-        server.registerPrompt(promptName, {
-            title: `Apply subagent: ${a.name}`,
-            description: `Apply the "${a.name}" subagent. Use when the user wants this agent's behavior.`,
-            argsSchema: {
-                user_message: z.string().describe("What the user asked or the current task"),
-            },
-        }, async ({ user_message }) => {
-            const entry = DATA.content.subagents[a.name];
-            const safeMessage = escapeForEmbedding(String(user_message ?? "(no message provided)"));
-            const text = `I will follow the **${a.name}** subagent.\n\n---\n\n${entry.content}\n\n---\n\nUser request: ${safeMessage}`;
-            return {
-                messages: [
-                    { role: "user", content: { type: "text", text: String(user_message ?? "") } },
-                    { role: "assistant", content: { type: "text", text } },
-                ],
-            };
-        });
+    const entry = DATA.content.skills[skill.name];
+    let text = entry.content;
+    if (include_reference && entry.reference) {
+        text += "\n\n---\n\n## Reference\n\n" + entry.reference;
     }
-    return server;
+    return { content: [{ type: "text", text }] };
+});
+server.registerTool("get_subagent", {
+    title: "Get subagent content",
+    description: "Get the full content of a subagent by name (id). Use list_subagents to see available names.",
+    inputSchema: z.object({
+        name: z.string().max(200).describe("Subagent id (e.g. deep-research, update-docs, verifier)"),
+    }),
+}, async ({ name }) => {
+    const subagent = DATA.subagents.find((a) => a.id === name || a.name === name);
+    if (!subagent) {
+        return {
+            content: [{ type: "text", text: `Unknown subagent: ${escapeForEmbedding(name)}. Use list_subagents to see available subagents.` }],
+            isError: true,
+        };
+    }
+    const entry = DATA.content.subagents[subagent.name];
+    return { content: [{ type: "text", text: entry.content }] };
+});
+// --- Prompts: apply skill / subagent with user message ---
+for (const s of DATA.skills) {
+    const promptName = `apply_skill_${s.id.replace(/-/g, "_")}`;
+    server.registerPrompt(promptName, {
+        title: `Apply skill: ${s.name}`,
+        description: `Apply the "${s.name}" skill. Use when the user wants to follow this skill's process.`,
+        argsSchema: {
+            user_message: z.string().describe("What the user asked or the current task"),
+        },
+    }, async ({ user_message }) => {
+        const entry = DATA.content.skills[s.name];
+        const safeMessage = escapeForEmbedding(String(user_message ?? "(no message provided)"));
+        const text = `I will follow the **${s.name}** skill.\n\n---\n\n${entry.content}\n\n---\n\nUser request: ${safeMessage}`;
+        return {
+            messages: [
+                { role: "user", content: { type: "text", text: String(user_message ?? "") } },
+                { role: "assistant", content: { type: "text", text } },
+            ],
+        };
+    });
 }
-/** Returns a server instance for Smithery capability scanning. Loads real content when dist/content.json exists (e.g. when scan runs from project dir), otherwise uses empty content so the scan still succeeds. */
-export function createSandboxServer() {
-    return createServer();
+for (const a of DATA.subagents) {
+    const promptName = `apply_subagent_${a.id.replace(/-/g, "_")}`;
+    server.registerPrompt(promptName, {
+        title: `Apply subagent: ${a.name}`,
+        description: `Apply the "${a.name}" subagent. Use when the user wants this agent's behavior.`,
+        argsSchema: {
+            user_message: z.string().describe("What the user asked or the current task"),
+        },
+    }, async ({ user_message }) => {
+        const entry = DATA.content.subagents[a.name];
+        const safeMessage = escapeForEmbedding(String(user_message ?? "(no message provided)"));
+        const text = `I will follow the **${a.name}** subagent.\n\n---\n\n${entry.content}\n\n---\n\nUser request: ${safeMessage}`;
+        return {
+            messages: [
+                { role: "user", content: { type: "text", text: String(user_message ?? "") } },
+                { role: "assistant", content: { type: "text", text } },
+            ],
+        };
+    });
 }
-// Default export for Smithery CLI (expects default to be a function that returns the server)
-export default createSandboxServer;
-// --- Run when executed as main ---
-const server = createServer();
+// --- Run ---
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/package.json CHANGED Viewed

@@ -1,38 +1,38 @@
-{
-  "name": "general-coding-tools-mcp",
-  "version": "1.0.2",
-  "description": "MCP server exposing General Coding Tools (skills and subagents) for use in Cursor, Claude, and Smithery",
-  "type": "module",
-  "main": "dist/index.js",
-  "bin": {
-    "general-coding-tools-mcp": "dist/index.js"
-  },
-  "scripts": {
-    "build": "node scripts/bundle-content.cjs && tsc",
-    "prepare": "npm run build",
-    "prepublishOnly": "npm run build",
-    "start": "node dist/index.js"
-  },
-  "files": [
-    "dist"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "keywords": [
-    "mcp",
-    "cursor",
-    "smithery",
-    "skills",
-    "general-coding-tools"
-  ],
-  "license": "MIT",
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.26.0",
-    "zod": "^3.23.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "typescript": "^5.0.0"
-  }
-}
+{
+  "name": "general-coding-tools-mcp",
+  "version": "1.0.3",
+  "description": "MCP server exposing General Coding Tools (skills and subagents) for use in Cursor, Claude, and Smithery",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "general-coding-tools-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "node scripts/bundle-content.cjs && tsc",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "cursor",
+    "smithery",
+    "skills",
+    "general-coding-tools"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  }
+}