mcp-new 0.1.0 → 1.2.0

package/templates/python/README.md.ejs

@@ -1,6 +1,6 @@
 # <%= name %>
 
-<%= description || 'MCP Server generated by create-mcp-server' %>
+<%= description || 'MCP Server generated with mcp-generator' %>
 
 ## Installation
 
@@ -28,14 +28,12 @@ Or if installed:
 <%= name %>
 ```
 
-## Configuration
+## Claude Desktop Configuration
 
-### Claude Desktop
+Add the following to your Claude Desktop config file:
 
-Add this to your Claude Desktop config file:
-
-**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
-**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
 
 ```json
 {
@@ -43,7 +41,7 @@ Add this to your Claude Desktop config file:
     "<%= name %>": {
       "command": "python",
       "args": ["-m", "src.server"],
-      "cwd": "<path-to-project>"
+      "cwd": "<%= process.cwd().replace(/\\/g, '/') %>/<%= name %>"
     }
   }
 }
@@ -52,26 +50,71 @@ Add this to your Claude Desktop config file:
 ## Available Tools
 
 <% if (includeExampleTool) { %>
-### example_tool
+### `example_tool`
 
 A sample tool that demonstrates basic MCP tool functionality.
 
-**Parameters:**
-- `query` (string, required): The query parameter
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `query` | string | Yes | The query parameter |
+
+**Example:**
+```json
+{
+  "name": "example_tool",
+  "arguments": {
+    "query": "hello world"
+  }
+}
+```
 
 <% } %>
 <% tools.forEach(function(tool) { %>
-### <%= tool.name %>
+### `<%= 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 %>
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+<% tool.parameters.forEach(function(param) { %>| `<%= param.name %>` | <%= param.type %> | <%= param.required ? 'Yes' : 'No' %> | <%= param.description %> |
 <% }); %>
+
+**Example:**
+```json
+{
+  "name": "<%- tool.name %>",
+  "arguments": {
+<% var reqParams = tool.parameters.filter(p => p.required); reqParams.forEach(function(param, index) { var val = param.type === 'string' ? '"value"' : param.type === 'number' ? '0' : param.type === 'boolean' ? 'true' : param.type === 'array' ? '[]' : '{}'; %>    "<%- param.name %>": <%- val %><% if (index < reqParams.length - 1) { %>,<% } %>
+<% }); %>  }
+}
+```
+<% } else { %>
+*This tool has no parameters.*
+
+**Example:**
+```json
+{
+  "name": "<%= tool.name %>",
+  "arguments": {}
+}
+```
 <% } %>
+
 <% }); %>
+## Project Structure
+
+```
+<%= name %>/
+├── src/
+│   ├── __init__.py
+│   ├── server.py     # Main server file
+│   └── tools/
+│       └── __init__.py
+├── pyproject.toml
+├── requirements.txt
+└── README.md
+```
 
 ## License
 

package/templates/rust/.env.example

@@ -0,0 +1,8 @@
+# Environment variables for the MCP server
+# Copy this file to .env and fill in the values
+
+# Logging level
+RUST_LOG=info
+
+# Add your environment variables here
+# API_KEY=your_api_key

package/templates/rust/.gitignore.ejs

@@ -0,0 +1,19 @@
+# Generated by Cargo
+/target/
+
+# Cargo.lock for binaries
+Cargo.lock
+
+# Environment
+.env
+.env.local
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db

package/templates/rust/Cargo.toml.ejs

@@ -0,0 +1,18 @@
+[package]
+name = "<%= name %>"
+version = "0.1.0"
+edition = "2021"
+description = "<%= description || 'MCP Server generated by mcp-generator' %>"
+
+[dependencies]
+rmcp = { version = "0.1", features = ["server"<% if (transport === 'stdio') { %>, "transport-io"<% } else { %>, "transport-sse-server"<% } %>] }
+tokio = { version = "1", features = ["full"] }
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"
+anyhow = "1"
+tracing = "0.1"
+tracing-subscriber = { version = "0.3", features = ["env-filter"] }
+
+[[bin]]
+name = "<%= name %>"
+path = "src/main.rs"

package/templates/rust/README.md.ejs

@@ -0,0 +1,155 @@
+# <%= name %>
+
+<%= description || 'MCP Server generated with mcp-generator' %>
+
+## Overview
+
+This is an MCP (Model Context Protocol) server built with Rust using the [rmcp](https://github.com/anthropics/rmcp) SDK.
+
+## Prerequisites
+
+- Rust 1.70 or higher
+- Cargo
+
+## Installation
+
+```bash
+# Build the project
+cargo build --release
+```
+
+## Running the Server
+
+<% if (transport === 'stdio') { %>
+### STDIO Transport
+
+```bash
+cargo run --release
+# or
+./target/release/<%= name %>
+```
+
+The server communicates via standard input/output.
+<% } else { %>
+### SSE Transport
+
+```bash
+cargo run --release
+# or
+./target/release/<%= name %>
+```
+
+The server will start an HTTP server with SSE endpoint on port 8080.
+<% } %>
+
+## Claude Desktop Configuration
+
+Add the following 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": "<%- process.cwd().replace(/\\/g, '/') %>/<%- name %>/target/release/<%- name %>"
+    }
+  }
+}
+```
+
+## Available Tools
+
+<% if (includeExampleTool) { %>
+### `example_tool`
+
+An example tool that echoes the input.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `input` | string | Yes | Input to echo |
+
+**Example:**
+```json
+{
+  "name": "example_tool",
+  "arguments": {
+    "input": "hello"
+  }
+}
+```
+
+<% } %>
+<% tools.forEach(function(tool) { %>
+### `<%- tool.name %>`
+
+<%= tool.description %>
+
+<% if (tool.parameters && tool.parameters.length > 0) { %>
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+<% tool.parameters.forEach(function(param) { %>| `<%= param.name %>` | <%= param.type %> | <%= param.required ? 'Yes' : 'No' %> | <%= param.description %> |
+<% }); %>
+
+**Example:**
+```json
+{
+  "name": "<%- tool.name %>",
+  "arguments": {
+<% var reqParams = tool.parameters.filter(p => p.required); reqParams.forEach(function(param, index) { var val = param.type === 'string' ? '"value"' : param.type === 'number' ? '0' : param.type === 'boolean' ? 'true' : param.type === 'array' ? '[]' : '{}'; %>    "<%- param.name %>": <%- val %><% if (index < reqParams.length - 1) { %>,<% } %>
+<% }); %>  }
+}
+```
+<% } else { %>
+*This tool has no parameters.*
+
+**Example:**
+```json
+{
+  "name": "<%- tool.name %>",
+  "arguments": {}
+}
+```
+<% } %>
+
+<% }); %>
+## Development
+
+```bash
+# Run in development mode
+cargo run
+
+# Run tests
+cargo test
+
+# Check for issues
+cargo clippy
+
+# Format code
+cargo fmt
+
+# Build release
+cargo build --release
+```
+
+## Testing with MCP Inspector
+
+```bash
+npx @modelcontextprotocol/inspector ./target/release/<%= name %>
+```
+
+## Project Structure
+
+```
+<%= name %>/
+├── src/
+│   ├── main.rs          # Server entry point
+│   └── tools.rs         # Tool implementations
+├── Cargo.toml
+└── README.md
+```
+
+## License
+
+MIT

package/templates/rust/src/main.rs.ejs

@@ -0,0 +1,46 @@
+use anyhow::Result;
+use rmcp::{
+    model::{CallToolResult, Content, Tool, ToolInputSchema},
+    server::Server,
+    tool,
+};
+use serde_json::{json, Value};
+use std::collections::HashMap;
+use tracing_subscriber::{layer::SubscriberExt, util::SubscriberInitExt};
+
+mod tools;
+
+#[tokio::main]
+async fn main() -> Result<()> {
+    // Initialize logging
+    tracing_subscriber::registry()
+        .with(tracing_subscriber::EnvFilter::new(
+            std::env::var("RUST_LOG").unwrap_or_else(|_| "info".into()),
+        ))
+        .with(tracing_subscriber::fmt::layer().with_writer(std::io::stderr))
+        .init();
+
+    tracing::info!("Starting <%= name %> MCP server");
+
+    // Create server
+    let server = Server::builder()
+        .name("<%= name %>")
+        .version("1.0.0")
+<% if (includeExampleTool) { %>
+        .tool(tools::example_tool())
+<% } %>
+<% tools.forEach(function(tool) { %>
+        .tool(tools::<%= tool.name %>_tool())
+<% }); %>
+        .build();
+
+<% if (transport === 'stdio') { %>
+    // Run with STDIO transport
+    server.run_stdio().await?;
+<% } else { %>
+    // Run with SSE transport
+    server.run_sse("0.0.0.0:8080", "/messages").await?;
+<% } %>
+
+    Ok(())
+}

package/templates/rust/src/tools.rs.ejs

@@ -0,0 +1,105 @@
+use rmcp::{
+    model::{CallToolResult, Content, Tool, ToolInputSchema},
+    tool,
+};
+use serde::{Deserialize, Serialize};
+use serde_json::{json, Value};
+use std::collections::HashMap;
+
+<% if (includeExampleTool) { %>
+/// Example tool that echoes the input
+#[derive(Debug, Deserialize)]
+pub struct ExampleToolInput {
+    pub query: String,
+}
+
+pub fn example_tool() -> Tool {
+    Tool {
+        name: "example_tool".to_string(),
+        description: Some("An example tool that echoes the input".to_string()),
+        input_schema: ToolInputSchema {
+            r#type: "object".to_string(),
+            properties: Some({
+                let mut props = HashMap::new();
+                props.insert(
+                    "query".to_string(),
+                    json!({
+                        "type": "string",
+                        "description": "The query to echo"
+                    }),
+                );
+                props
+            }),
+            required: Some(vec!["query".to_string()]),
+        },
+        handler: Box::new(|args| {
+            Box::pin(async move {
+                let input: ExampleToolInput = serde_json::from_value(args)?;
+                Ok(CallToolResult {
+                    content: vec![Content::Text {
+                        text: format!("Echo: {}", input.query),
+                    }],
+                    is_error: None,
+                })
+            })
+        }),
+    }
+}
+<% } %>
+
+<% tools.forEach(function(tool) { %>
+/// <%= tool.description %>
+#[derive(Debug, Deserialize)]
+pub struct <%= tool.name.charAt(0).toUpperCase() + tool.name.slice(1).replace(/_([a-z])/g, (_, c) => c.toUpperCase()) %>Input {
+<% tool.parameters.forEach(function(param) { %>
+<% if (param.type === 'number') { %>
+    pub <%= param.name %>: f64,
+<% } else if (param.type === 'boolean') { %>
+    pub <%= param.name %>: bool,
+<% } else if (param.type === 'array') { %>
+    pub <%= param.name %>: Vec<Value>,
+<% } else if (param.type === 'object') { %>
+    pub <%= param.name %>: HashMap<String, Value>,
+<% } else { %>
+    pub <%= param.name %>: String,
+<% } %>
+<% }); %>
+}
+
+pub fn <%= tool.name %>_tool() -> Tool {
+    Tool {
+        name: "<%= tool.name %>".to_string(),
+        description: Some("<%= tool.description %>".to_string()),
+        input_schema: ToolInputSchema {
+            r#type: "object".to_string(),
+            properties: Some({
+                let mut props = HashMap::new();
+<% tool.parameters.forEach(function(param) { %>
+                props.insert(
+                    "<%= param.name %>".to_string(),
+                    json!({
+                        "type": "<%= param.type %>",
+                        "description": "<%= param.description %>"
+                    }),
+                );
+<% }); %>
+                props
+            }),
+            required: Some(vec![<%= tool.parameters.filter(p => p.required).map(p => '"' + p.name + '".to_string()').join(', ') %>]),
+        },
+        handler: Box::new(|args| {
+            Box::pin(async move {
+                // TODO: Implement <%= tool.name %> logic
+                let input: <%= tool.name.charAt(0).toUpperCase() + tool.name.slice(1).replace(/_([a-z])/g, (_, c) => c.toUpperCase()) %>Input = serde_json::from_value(args.clone())?;
+
+                Ok(CallToolResult {
+                    content: vec![Content::Text {
+                        text: format!("<%= tool.name %> called with: {:?}", args),
+                    }],
+                    is_error: None,
+                })
+            })
+        }),
+    }
+}
+<% }); %>

package/templates/typescript/README.md.ejs

@@ -1,6 +1,6 @@
 # <%= name %>
 
-<%= description || 'MCP Server generated by create-mcp-server' %>
+<%= description || 'MCP Server generated with mcp-generator' %>
 
 ## Installation
 
@@ -29,21 +29,19 @@ npm run dev
 npm run inspector
 ```
 
-## Configuration
+## Claude Desktop Configuration
 
-### Claude Desktop
+Add the following to your Claude Desktop config file:
 
-Add this to your Claude Desktop config file:
-
-**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
-**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+- **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"]
+      "args": ["<%= process.cwd().replace(/\\/g, '/') %>/<%= name %>/dist/index.js"]
     }
   }
 }
@@ -52,26 +50,69 @@ Add this to your Claude Desktop config file:
 ## Available Tools
 
 <% if (includeExampleTool) { %>
-### example_tool
+### `example_tool`
 
 A sample tool that demonstrates basic MCP tool functionality.
 
-**Parameters:**
-- `query` (string, required): The query parameter
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `query` | string | Yes | The query parameter |
+
+**Example:**
+```json
+{
+  "name": "example_tool",
+  "arguments": {
+    "query": "hello world"
+  }
+}
+```
 
 <% } %>
 <% tools.forEach(function(tool) { %>
-### <%= tool.name %>
+### `<%= 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 %>
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+<% tool.parameters.forEach(function(param) { %>| `<%= param.name %>` | <%= param.type %> | <%= param.required ? 'Yes' : 'No' %> | <%= param.description %> |
 <% }); %>
+
+**Example:**
+```json
+{
+  "name": "<%- tool.name %>",
+  "arguments": {
+<% var reqParams = tool.parameters.filter(p => p.required); reqParams.forEach(function(param, index) { var val = param.type === 'string' ? '"value"' : param.type === 'number' ? '0' : param.type === 'boolean' ? 'true' : param.type === 'array' ? '[]' : '{}'; %>    "<%- param.name %>": <%- val %><% if (index < reqParams.length - 1) { %>,<% } %>
+<% }); %>  }
+}
+```
+<% } else { %>
+*This tool has no parameters.*
+
+**Example:**
+```json
+{
+  "name": "<%= tool.name %>",
+  "arguments": {}
+}
+```
 <% } %>
+
 <% }); %>
+## Project Structure
+
+```
+<%= name %>/
+├── src/
+│   └── index.ts      # Main server file
+├── dist/             # Compiled output
+├── package.json
+├── tsconfig.json
+└── README.md
+```
 
 ## License