Initial commit

skills/claude-code/mcp-server-creator/templates/package.json.template

@@ -0,0 +1,25 @@
+{
+  "name": "{{SERVER_NAME}}",
+  "version": "1.0.0",
+  "description": "{{SERVER_DESCRIPTION}}",
+  "type": "module",
+  "main": "build/index.js",
+  "scripts": {
+    "build": "tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"",
+    "watch": "tsc --watch",
+    "start": "node build/index.js",
+    "inspect": "npx @modelcontextprotocol/inspector node build/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0"{{#EXTRA_DEPS}},
+    {{EXTRA_DEPS}}{{/EXTRA_DEPS}}
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  },
+  "keywords": ["mcp", "model-context-protocol", "{{SERVER_NAME}}"],
+  "author": "{{AUTHOR}}",
+  "license": "MIT"
+}

skills/claude-code/mcp-server-creator/templates/python-server.py.template

@@ -0,0 +1,98 @@
+#!/usr/bin/env python3
+"""
+{{SERVER_NAME}} MCP Server
+
+{{SERVER_DESCRIPTION}}
+"""
+
+from mcp.server.fastmcp import FastMCP
+import os
+from typing import Optional
+import logging
+
+# Configure logging to stderr (CRITICAL: never log to stdout in STDIO mode)
+logging.basicConfig(
+    level=logging.INFO,
+    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
+    handlers=[logging.StreamHandler()]  # Writes to stderr by default
+)
+logger = logging.getLogger(__name__)
+
+# Initialize MCP server
+mcp = FastMCP("{{SERVER_NAME}}")
+
+{{#TOOLS}}
+@mcp.tool()
+async def {{TOOL_FUNCTION}}({{TOOL_PARAMS_TYPED}}) -> {{TOOL_RETURN_TYPE}}:
+    """
+    {{TOOL_DESCRIPTION}}
+
+    Args:
+        {{#TOOL_PARAMS}}
+        {{PARAM_NAME}}: {{PARAM_DESCRIPTION}}
+        {{/TOOL_PARAMS}}
+
+    Returns:
+        {{TOOL_RETURN_DESCRIPTION}}
+    """
+    try:
+        logger.info(f"{{TOOL_FUNCTION}} called with: {{TOOL_PARAMS_LOG}}")
+
+        # TODO: Implement your tool logic here
+        result = None  # Replace with actual implementation
+
+        return str(result)
+    except Exception as e:
+        logger.error(f"Error in {{TOOL_FUNCTION}}: {str(e)}")
+        raise
+
+{{/TOOLS}}
+
+{{#HAS_RESOURCES}}
+@mcp.resource("{{RESOURCE_URI_PATTERN}}")
+async def get_resource({{RESOURCE_PARAMS}}) -> str:
+    """
+    {{RESOURCE_DESCRIPTION}}
+
+    Args:
+        {{#RESOURCE_PARAMS_LIST}}
+        {{PARAM_NAME}}: {{PARAM_DESCRIPTION}}
+        {{/RESOURCE_PARAMS_LIST}}
+
+    Returns:
+        Resource content as string
+    """
+    try:
+        logger.info(f"Resource requested: {{RESOURCE_PARAMS_LOG}}")
+
+        # TODO: Implement resource fetching logic
+        content = ""  # Replace with actual implementation
+
+        return content
+    except Exception as e:
+        logger.error(f"Error fetching resource: {str(e)}")
+        raise
+{{/HAS_RESOURCES}}
+
+{{#HAS_PROMPTS}}
+@mcp.prompt()
+async def {{PROMPT_NAME}}({{PROMPT_PARAMS}}) -> str:
+    """
+    {{PROMPT_DESCRIPTION}}
+
+    Args:
+        {{#PROMPT_PARAMS_LIST}}
+        {{PARAM_NAME}}: {{PARAM_DESCRIPTION}}
+        {{/PROMPT_PARAMS_LIST}}
+
+    Returns:
+        Formatted prompt template
+    """
+    return f"""
+{{PROMPT_TEMPLATE}}
+"""
+{{/HAS_PROMPTS}}
+
+if __name__ == "__main__":
+    logger.info("Starting {{SERVER_NAME}} MCP server...")
+    mcp.run()

skills/claude-code/mcp-server-creator/templates/tsconfig.json.template

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "outDir": "./build",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "build"]
+}

skills/claude-code/mcp-server-creator/templates/typescript-server.ts.template

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+
+// Server metadata
+const SERVER_NAME = "{{SERVER_NAME}}";
+const SERVER_VERSION = "1.0.0";
+
+// Initialize MCP server
+const server = new Server(
+  {
+    name: SERVER_NAME,
+    version: SERVER_VERSION,
+  },
+  {
+    capabilities: {
+      tools: {},
+      {{#HAS_RESOURCES}}resources: {},{{/HAS_RESOURCES}}
+      {{#HAS_PROMPTS}}prompts: {},{{/HAS_PROMPTS}}
+    },
+  }
+);
+
+// List available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    {{#TOOLS}}
+    {
+      name: "{{TOOL_NAME}}",
+      description: "{{TOOL_DESCRIPTION}}",
+      inputSchema: {
+        type: "object",
+        properties: {
+          {{#TOOL_PARAMS}}
+          {{PARAM_NAME}}: {
+            type: "{{PARAM_TYPE}}",
+            description: "{{PARAM_DESCRIPTION}}",
+          },
+          {{/TOOL_PARAMS}}
+        },
+        required: [{{REQUIRED_PARAMS}}],
+      },
+    },
+    {{/TOOLS}}
+  ],
+}));
+
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  {{#TOOLS}}
+  if (name === "{{TOOL_NAME}}") {
+    try {
+      // TODO: Implement {{TOOL_NAME}} logic
+      {{#TOOL_PARAMS}}
+      const {{PARAM_NAME}} = args.{{PARAM_NAME}} as {{PARAM_TS_TYPE}};
+      {{/TOOL_PARAMS}}
+
+      // Your implementation here
+      const result = await {{TOOL_FUNCTION}}({{PARAM_NAMES}});
+
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2),
+          },
+        ],
+      };
+    } catch (error) {
+      console.error(`Error in {{TOOL_NAME}}:`, error);
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+          },
+        ],
+        isError: true,
+      };
+    }
+  }
+
+  {{/TOOLS}}
+
+  throw new Error(`Unknown tool: ${name}`);
+});
+
+{{#HAS_RESOURCES}}
+// TODO: Implement resource handlers
+// Example:
+// server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+//   resources: [
+//     {
+//       uri: "resource://template/{id}",
+//       name: "Resource Name",
+//       description: "Resource description",
+//     },
+//   ],
+// }));
+{{/HAS_RESOURCES}}
+
+{{#HAS_PROMPTS}}
+// TODO: Implement prompt handlers
+// Example:
+// server.setRequestHandler(ListPromptsRequestSchema, async () => ({
+//   prompts: [
+//     {
+//       name: "prompt_name",
+//       description: "Prompt description",
+//       arguments: [
+//         {
+//           name: "arg_name",
+//           description: "Argument description",
+//           required: true,
+//         },
+//       ],
+//     },
+//   ],
+// }));
+{{/HAS_PROMPTS}}
+
+// Start server
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+
+  // CRITICAL: Never use console.log() in STDIO mode - it corrupts the JSON-RPC stream!
+  console.error(`${SERVER_NAME} MCP server running on stdio`);
+}
+
+main().catch((error) => {
+  console.error("Fatal error:", error);
+  process.exit(1);
+});