mcp-new 1.2.2 → 1.5.0

package/templates/java/maven/src/main/java/com/example/mcp/McpServer.java.ejs

@@ -0,0 +1,149 @@
+package com.example.mcp;
+
+import io.modelcontextprotocol.server.McpServer;
+import io.modelcontextprotocol.server.McpServerOptions;
+import io.modelcontextprotocol.server.ServerCapabilities;
+<% if (transport === 'stdio') { %>
+import io.modelcontextprotocol.server.transport.StdioServerTransport;
+<% } else { %>
+import io.modelcontextprotocol.server.transport.SseServerTransport;
+<% } %>
+import io.modelcontextprotocol.spec.McpSchema;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * <%= name %> MCP Server
+ * <%= description || 'Generated by mcp-new' %>
+ */
+public class McpServer {
+    private static final Logger logger = LoggerFactory.getLogger(McpServer.class);
+    private static final ObjectMapper objectMapper = new ObjectMapper();
+
+    public static void main(String[] args) {
+        try {
+            // Create server options
+            McpServerOptions options = McpServerOptions.builder()
+                .name("<%= name %>")
+                .version("1.0.0")
+                .capabilities(ServerCapabilities.builder()
+                    .tools(true)
+                    .build())
+                .build();
+
+            // Create server instance
+            io.modelcontextprotocol.server.McpServer server = 
+                new io.modelcontextprotocol.server.McpServer(options);
+
+            // Register tools
+            registerTools(server);
+
+<% if (transport === 'stdio') { %>
+            // Create STDIO transport
+            StdioServerTransport transport = new StdioServerTransport();
+            server.connect(transport);
+            logger.info("<%= name %> MCP server running on stdio");
+<% } else { %>
+            // Create SSE transport
+            SseServerTransport transport = new SseServerTransport(8080, "/messages");
+            server.connect(transport);
+            logger.info("<%= name %> MCP server running on SSE at http://localhost:8080");
+<% } %>
+
+            // Keep server running
+            Thread.currentThread().join();
+
+        } catch (Exception e) {
+            logger.error("Fatal error: ", e);
+            System.exit(1);
+        }
+    }
+
+    private static void registerTools(io.modelcontextprotocol.server.McpServer server) {
+<% if (includeExampleTool) { %>
+        // Register example_tool
+        server.addTool(
+            McpSchema.Tool.builder()
+                .name("example_tool")
+                .description("An example tool that echoes the input")
+                .inputSchema(createInputSchema(
+                    Map.of("query", Map.of(
+                        "type", "string",
+                        "description", "The query to echo"
+                    )),
+                    List.of("query")
+                ))
+                .build(),
+            (request) -> {
+                String query = (String) request.getArguments().get("query");
+                return McpSchema.CallToolResult.builder()
+                    .content(List.of(
+                        McpSchema.TextContent.builder()
+                            .type("text")
+                            .text("Echo: " + query)
+                            .build()
+                    ))
+                    .build();
+            }
+        );
+<% } %>
+
+<% tools.forEach(function(tool) { %>
+        // Register <%= tool.name %>
+        server.addTool(
+            McpSchema.Tool.builder()
+                .name("<%= tool.name %>")
+                .description("<%= tool.description %>")
+                .inputSchema(createInputSchema(
+                    Map.of(
+<% tool.parameters.forEach(function(param, index) { %>
+                        "<%= param.name %>", Map.of(
+                            "type", "<%= param.type %>",
+                            "description", "<%= param.description %>"
+                        )<%= index < tool.parameters.length - 1 ? ',' : '' %>
+<% }); %>
+                    ),
+                    List.of(<%= tool.parameters.filter(p => p.required).map(p => '"' + p.name + '"').join(', ') %>)
+                ))
+                .build(),
+            (request) -> {
+                // TODO: Implement <%= tool.name %> logic
+<% tool.parameters.forEach(function(param) { %>
+<% if (param.type === 'number') { %>
+                Number <%= param.name %> = (Number) request.getArguments().get("<%= param.name %>");
+<% } else if (param.type === 'boolean') { %>
+                Boolean <%= param.name %> = (Boolean) request.getArguments().get("<%= param.name %>");
+<% } else { %>
+                String <%= param.name %> = (String) request.getArguments().get("<%= param.name %>");
+<% } %>
+<% }); %>
+
+                return McpSchema.CallToolResult.builder()
+                    .content(List.of(
+                        McpSchema.TextContent.builder()
+                            .type("text")
+                            .text("<%= tool.name %> called with: " + request.getArguments())
+                            .build()
+                    ))
+                    .build();
+            }
+        );
+<% }); %>
+    }
+
+    private static Map<String, Object> createInputSchema(
+            Map<String, Map<String, String>> properties, 
+            List<String> required) {
+        Map<String, Object> schema = new HashMap<>();
+        schema.put("type", "object");
+        schema.put("properties", properties);
+        schema.put("required", required);
+        return schema;
+    }
+}

package/templates/java/maven/src/main/resources/logback.xml

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<configuration>
+    <appender name="STDERR" class="ch.qos.logback.core.ConsoleAppender">
+        <target>System.err</target>
+        <encoder>
+            <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
+        </encoder>
+    </appender>
+
+    <root level="INFO">
+        <appender-ref ref="STDERR"/>
+    </root>
+</configuration>

package/templates/kotlin/gradle/.env.example

@@ -0,0 +1,6 @@
+# Environment variables for MCP Server
+# Copy this file to .env and fill in your values
+
+# Add your environment variables here
+# API_KEY=your_api_key
+# DATABASE_URL=your_database_url

package/templates/kotlin/gradle/.gitignore.ejs

@@ -0,0 +1,45 @@
+# Compiled class files
+*.class
+
+# Log files
+*.log
+
+# Package Files
+*.jar
+*.war
+*.nar
+*.ear
+*.zip
+*.tar.gz
+*.rar
+
+# Gradle
+.gradle/
+build/
+gradle-app.setting
+!gradle-wrapper.jar
+.gradletasknamecache
+
+# Kotlin
+*.kotlin_module
+
+# IDE
+.idea/
+*.iml
+*.ipr
+*.iws
+.project
+.classpath
+.settings/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Environment
+.env
+.env.local

package/templates/kotlin/gradle/README.md.ejs

@@ -0,0 +1,138 @@
+# <%= name %>
+
+<%= description || 'MCP Server generated by mcp-new' %>
+
+## Prerequisites
+
+- JDK 17 or higher
+- Gradle 8.0+ (or use included Gradle wrapper)
+
+## Installation
+
+```bash
+# Install dependencies and build
+./gradlew build
+
+# Or on Windows
+gradlew.bat build
+```
+
+## Running the Server
+
+### Development
+
+```bash
+# Run directly with Gradle
+./gradlew run
+```
+
+### Production
+
+```bash
+# Build executable JAR (shadow JAR with all dependencies)
+./gradlew shadowJar
+
+# Run the JAR
+java -jar build/libs/<%= name %>-1.0.0.jar
+```
+
+## Configuration with 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": "java",
+      "args": ["-jar", "/path/to/<%= name %>/build/libs/<%= name %>-1.0.0.jar"]
+    }
+  }
+}
+```
+
+## Available Tools
+
+<% if (includeExampleTool) { %>
+### example_tool
+An example tool that echoes the input
+
+**Parameters:**
+- `query` (string, required): The query to echo
+<% } %>
+
+<% tools.forEach(function(tool) { %>
+### <%= tool.name %>
+<%= tool.description %>
+
+**Parameters:**
+<% tool.parameters.forEach(function(param) { %>
+- `<%= param.name %>` (<%= param.type %><%= param.required ? ', required' : '' %>): <%= param.description %>
+<% }); %>
+<% }); %>
+
+## Project Structure
+
+```
+<%= name %>/
+├── build.gradle.kts                  # Gradle configuration (Kotlin DSL)
+├── settings.gradle.kts               # Project settings
+├── src/
+│   └── main/
+│       ├── kotlin/
+│       │   └── com/example/mcp/
+│       │       └── McpServer.kt      # Main server file
+│       └── resources/
+│           └── logback.xml           # Logging configuration
+├── .gitignore
+├── .env.example
+└── README.md
+```
+
+## Development
+
+### Adding a New Tool
+
+1. Open `src/main/kotlin/com/example/mcp/McpServer.kt`
+2. Add a new tool registration in the `registerTools` function:
+
+```kotlin
+server.addTool(
+    McpSchema.Tool.builder()
+        .name("my_new_tool")
+        .description("Description of my tool")
+        .inputSchema(
+            mapOf(
+                "type" to "object",
+                "properties" to mapOf(
+                    "param1" to mapOf(
+                        "type" to "string",
+                        "description" to "Parameter description"
+                    )
+                ),
+                "required" to listOf("param1")
+            )
+        )
+        .build()
+) { request ->
+    val param1 = request.arguments["param1"] as? String
+    // Your tool logic here
+    McpSchema.CallToolResult.builder()
+        .content(
+            listOf(
+                McpSchema.TextContent.builder()
+                    .type("text")
+                    .text("Result: $param1")
+                    .build()
+            )
+        )
+        .build()
+}
+```
+
+## License
+
+MIT

package/templates/kotlin/gradle/build.gradle.kts.ejs

@@ -0,0 +1,48 @@
+plugins {
+    kotlin("jvm") version "1.9.22"
+    application
+    id("com.github.johnrengelman.shadow") version "8.1.1"
+}
+
+group = "com.example"
+version = "1.0.0"
+
+repositories {
+    mavenCentral()
+}
+
+dependencies {
+    // MCP SDK
+    implementation("io.modelcontextprotocol:sdk:0.8.0")
+
+    // Kotlin coroutines
+    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.7.3")
+
+    // Logging
+    implementation("org.slf4j:slf4j-api:2.0.9")
+    implementation("ch.qos.logback:logback-classic:1.4.14")
+
+    // JSON processing
+    implementation("com.fasterxml.jackson.module:jackson-module-kotlin:2.16.1")
+}
+
+kotlin {
+    jvmToolchain(17)
+}
+
+application {
+    mainClass.set("com.example.mcp.McpServerKt")
+}
+
+tasks.shadowJar {
+    archiveBaseName.set("<%= name %>")
+    archiveClassifier.set("")
+    archiveVersion.set("1.0.0")
+    manifest {
+        attributes["Main-Class"] = "com.example.mcp.McpServerKt"
+    }
+}
+
+tasks.build {
+    dependsOn(tasks.shadowJar)
+}

package/templates/kotlin/gradle/settings.gradle.kts.ejs

@@ -0,0 +1 @@
+rootProject.name = "<%= name %>"

package/templates/kotlin/gradle/src/main/kotlin/com/example/mcp/McpServer.kt.ejs

@@ -0,0 +1,141 @@
+package com.example.mcp
+
+import io.modelcontextprotocol.server.McpServer
+import io.modelcontextprotocol.server.McpServerOptions
+import io.modelcontextprotocol.server.ServerCapabilities
+<% if (transport === 'stdio') { %>
+import io.modelcontextprotocol.server.transport.StdioServerTransport
+<% } else { %>
+import io.modelcontextprotocol.server.transport.SseServerTransport
+<% } %>
+import io.modelcontextprotocol.spec.McpSchema
+import org.slf4j.LoggerFactory
+
+/**
+ * <%= name %> MCP Server
+ * <%= description || 'Generated by mcp-new' %>
+ */
+
+private val logger = LoggerFactory.getLogger("McpServer")
+
+fun main() {
+    try {
+        // Create server options
+        val options = McpServerOptions.builder()
+            .name("<%= name %>")
+            .version("1.0.0")
+            .capabilities(
+                ServerCapabilities.builder()
+                    .tools(true)
+                    .build()
+            )
+            .build()
+
+        // Create server instance
+        val server = McpServer(options)
+
+        // Register tools
+        registerTools(server)
+
+<% if (transport === 'stdio') { %>
+        // Create STDIO transport
+        val transport = StdioServerTransport()
+        server.connect(transport)
+        logger.info("<%= name %> MCP server running on stdio")
+<% } else { %>
+        // Create SSE transport
+        val transport = SseServerTransport(8080, "/messages")
+        server.connect(transport)
+        logger.info("<%= name %> MCP server running on SSE at http://localhost:8080")
+<% } %>
+
+        // Keep server running
+        Thread.currentThread().join()
+
+    } catch (e: Exception) {
+        logger.error("Fatal error: ", e)
+        System.exit(1)
+    }
+}
+
+private fun registerTools(server: McpServer) {
+<% if (includeExampleTool) { %>
+    // Register example_tool
+    server.addTool(
+        McpSchema.Tool.builder()
+            .name("example_tool")
+            .description("An example tool that echoes the input")
+            .inputSchema(
+                mapOf(
+                    "type" to "object",
+                    "properties" to mapOf(
+                        "query" to mapOf(
+                            "type" to "string",
+                            "description" to "The query to echo"
+                        )
+                    ),
+                    "required" to listOf("query")
+                )
+            )
+            .build()
+    ) { request ->
+        val query = request.arguments["query"] as String
+        McpSchema.CallToolResult.builder()
+            .content(
+                listOf(
+                    McpSchema.TextContent.builder()
+                        .type("text")
+                        .text("Echo: $query")
+                        .build()
+                )
+            )
+            .build()
+    }
+<% } %>
+
+<% tools.forEach(function(tool) { %>
+    // Register <%= tool.name %>
+    server.addTool(
+        McpSchema.Tool.builder()
+            .name("<%= tool.name %>")
+            .description("<%= tool.description %>")
+            .inputSchema(
+                mapOf(
+                    "type" to "object",
+                    "properties" to mapOf(
+<% tool.parameters.forEach(function(param, index) { %>
+                        "<%= param.name %>" to mapOf(
+                            "type" to "<%= param.type %>",
+                            "description" to "<%= param.description %>"
+                        )<%= index < tool.parameters.length - 1 ? ',' : '' %>
+<% }); %>
+                    ),
+                    "required" to listOf(<%= tool.parameters.filter(p => p.required).map(p => '"' + p.name + '"').join(', ') %>)
+                )
+            )
+            .build()
+    ) { request ->
+        // TODO: Implement <%= tool.name %> logic
+<% tool.parameters.forEach(function(param) { %>
+<% if (param.type === 'number') { %>
+        val <%= param.name %> = request.arguments["<%= param.name %>"] as? Number
+<% } else if (param.type === 'boolean') { %>
+        val <%= param.name %> = request.arguments["<%= param.name %>"] as? Boolean
+<% } else { %>
+        val <%= param.name %> = request.arguments["<%= param.name %>"] as? String
+<% } %>
+<% }); %>
+
+        McpSchema.CallToolResult.builder()
+            .content(
+                listOf(
+                    McpSchema.TextContent.builder()
+                        .type("text")
+                        .text("<%= tool.name %> called with: ${request.arguments}")
+                        .build()
+                )
+            )
+            .build()
+    }
+<% }); %>
+}

package/templates/kotlin/gradle/src/main/resources/logback.xml

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<configuration>
+    <appender name="STDERR" class="ch.qos.logback.core.ConsoleAppender">
+        <target>System.err</target>
+        <encoder>
+            <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
+        </encoder>
+    </appender>
+
+    <root level="INFO">
+        <appender-ref ref="STDERR"/>
+    </root>
+</configuration>

package/templates/kotlin/maven/.env.example

@@ -0,0 +1,6 @@
+# Environment variables for MCP Server
+# Copy this file to .env and fill in your values
+
+# Add your environment variables here
+# API_KEY=your_api_key
+# DATABASE_URL=your_database_url

package/templates/kotlin/maven/.gitignore.ejs

@@ -0,0 +1,50 @@
+# Compiled class files
+*.class
+
+# Log files
+*.log
+
+# Package Files
+*.jar
+*.war
+*.nar
+*.ear
+*.zip
+*.tar.gz
+*.rar
+
+# Maven
+target/
+pom.xml.tag
+pom.xml.releaseBackup
+pom.xml.versionsBackup
+pom.xml.next
+release.properties
+dependency-reduced-pom.xml
+buildNumber.properties
+.mvn/timing.properties
+.mvn/wrapper/maven-wrapper.jar
+
+# Kotlin
+*.kotlin_module
+
+# IDE
+.idea/
+*.iml
+*.ipr
+*.iws
+.project
+.classpath
+.settings/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Environment
+.env
+.env.local