mcp-new 0.1.0

package/templates/python/src/tools/example_tool.py.ejs

@@ -0,0 +1,47 @@
+"""
+Example tool implementation
+This file demonstrates how to structure a tool handler
+"""
+
+from dataclasses import dataclass
+from mcp.types import Tool
+
+
+@dataclass
+class ExampleToolInput:
+    query: str
+
+
+@dataclass
+class ExampleToolOutput:
+    result: str
+
+
+async def example_tool(input_data: ExampleToolInput) -> ExampleToolOutput:
+    """
+    Example tool that processes a query.
+
+    Args:
+        input_data: The input containing the query
+
+    Returns:
+        The processed result
+    """
+    result = f"Processed: {input_data.query}"
+    return ExampleToolOutput(result=result)
+
+
+EXAMPLE_TOOL_SCHEMA = Tool(
+    name="example_tool",
+    description="An example tool that demonstrates the basic structure",
+    inputSchema={
+        "type": "object",
+        "properties": {
+            "query": {
+                "type": "string",
+                "description": "The query to process",
+            },
+        },
+        "required": ["query"],
+    },
+)

package/templates/typescript/.env.example

@@ -0,0 +1,8 @@
+# Environment variables for your MCP server
+# Copy this file to .env and fill in your values
+
+# Example API key
+# API_KEY=your-api-key-here
+
+# Server configuration
+# PORT=3000

package/templates/typescript/.gitignore.ejs

@@ -0,0 +1,22 @@
+# Dependencies
+node_modules/
+
+# Build output
+dist/
+
+# Environment
+.env
+.env.local
+
+# IDE
+.idea/
+.vscode/
+*.swp
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+npm-debug.log*

package/templates/typescript/README.md.ejs

@@ -0,0 +1,78 @@
+# <%= name %>
+
+<%= description || 'MCP Server generated by create-mcp-server' %>
+
+## Installation
+
+```bash
+npm install
+npm run build
+```
+
+## Usage
+
+### Running the server
+
+```bash
+npm start
+```
+
+### Development mode
+
+```bash
+npm run dev
+```
+
+### Using with MCP Inspector
+
+```bash
+npm run inspector
+```
+
+## Configuration
+
+### Claude Desktop
+
+Add this to your Claude Desktop config file:
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "<%= name %>": {
+      "command": "node",
+      "args": ["<path-to-project>/dist/index.js"]
+    }
+  }
+}
+```
+
+## Available Tools
+
+<% if (includeExampleTool) { %>
+### example_tool
+
+A sample tool that demonstrates basic MCP tool functionality.
+
+**Parameters:**
+- `query` (string, required): The query parameter
+
+<% } %>
+<% tools.forEach(function(tool) { %>
+### <%= tool.name %>
+
+<%= tool.description %>
+
+<% if (tool.parameters && tool.parameters.length > 0) { %>
+**Parameters:**
+<% tool.parameters.forEach(function(param) { %>
+- `<%= param.name %>` (<%= param.type %><%= param.required ? ', required' : '' %>): <%= param.description %>
+<% }); %>
+<% } %>
+<% }); %>
+
+## License
+
+MIT

package/templates/typescript/package.json.ejs

@@ -0,0 +1,29 @@
+{
+  "name": "<%= name %>",
+  "version": "1.0.0",
+  "description": "<%= description || 'MCP Server generated by create-mcp-server' %>",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "<%= name %>": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "inspector": "npx @modelcontextprotocol/inspector node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0"
+  }
+}

package/templates/typescript/src/index.ts.ejs

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+<% if (transport === 'stdio') { %>
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+<% } else { %>
+import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
+<% } %>
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+
+const server = new Server(
+  {
+    name: "<%= name %>",
+    version: "1.0.0",
+  },
+  {
+    capabilities: {
+      tools: {},
+    },
+  }
+);
+
+// Define available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+<% if (includeExampleTool) { %>
+    {
+      name: "example_tool",
+      description: "An example tool that echoes the input",
+      inputSchema: {
+        type: "object",
+        properties: {
+          query: {
+            type: "string",
+            description: "The query to echo",
+          },
+        },
+        required: ["query"],
+      },
+    },
+<% } %>
+<% tools.forEach(function(tool) { %>
+    {
+      name: "<%= tool.name %>",
+      description: "<%= tool.description %>",
+      inputSchema: {
+        type: "object",
+        properties: {
+<% tool.parameters.forEach(function(param, index) { %>
+          <%= param.name %>: {
+            type: "<%= param.type %>",
+            description: "<%= param.description %>",
+          }<%= index < tool.parameters.length - 1 ? ',' : '' %>
+<% }); %>
+        },
+        required: [<%- tool.parameters.filter(p => p.required).map(p => '"' + p.name + '"').join(', ') %>],
+      },
+    },
+<% }); %>
+  ],
+}));
+
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+<% if (includeExampleTool) { %>
+  if (name === "example_tool") {
+    const query = args?.query as string;
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Echo: ${query}`,
+        },
+      ],
+    };
+  }
+<% } %>
+
+<% tools.forEach(function(tool) { %>
+  if (name === "<%= tool.name %>") {
+    // TODO: Implement <%= tool.name %> logic
+<% tool.parameters.forEach(function(param) { %>
+    const <%= param.name %> = args?.<%= param.name %> as <%= param.type === 'number' ? 'number' : param.type === 'boolean' ? 'boolean' : 'string' %>;
+<% }); %>
+
+    return {
+      content: [
+        {
+          type: "text",
+          text: `<%= tool.name %> called with: ${JSON.stringify(args)}`,
+        },
+      ],
+    };
+  }
+<% }); %>
+
+  throw new Error(`Unknown tool: ${name}`);
+});
+
+// Start the server
+async function main() {
+<% if (transport === 'stdio') { %>
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("<%= name %> MCP server running on stdio");
+<% } else { %>
+  const transport = new SSEServerTransport("/messages", response);
+  await server.connect(transport);
+  console.error("<%= name %> MCP server running on SSE");
+<% } %>
+}
+
+main().catch((error) => {
+  console.error("Fatal error:", error);
+  process.exit(1);
+});

package/templates/typescript/src/tools/example-tool.ts.ejs

@@ -0,0 +1,36 @@
+/**
+ * Example tool implementation
+ * This file demonstrates how to structure a tool handler
+ */
+
+export interface ExampleToolInput {
+  query: string;
+}
+
+export interface ExampleToolOutput {
+  result: string;
+}
+
+export async function exampleTool(input: ExampleToolInput): Promise<ExampleToolOutput> {
+  const { query } = input;
+
+  // Your tool logic here
+  const result = `Processed: ${query}`;
+
+  return { result };
+}
+
+export const exampleToolSchema = {
+  name: "example_tool",
+  description: "An example tool that demonstrates the basic structure",
+  inputSchema: {
+    type: "object" as const,
+    properties: {
+      query: {
+        type: "string",
+        description: "The query to process",
+      },
+    },
+    required: ["query"],
+  },
+};

package/templates/typescript/tsconfig.json.ejs

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