mcp-new 1.2.2 → 1.6.0

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

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

@@ -0,0 +1,96 @@
+# <%= name %>
+
+<%= description || 'MCP Server generated by mcp-new' %>
+
+## Prerequisites
+
+- JDK 17 or higher
+- Maven 3.8+
+
+## Installation
+
+```bash
+# Install dependencies and build
+mvn install
+
+# Or just compile
+mvn compile
+```
+
+## Running the Server
+
+### Development
+
+```bash
+# Run directly with Maven
+mvn exec:java -Dexec.mainClass="com.example.mcp.McpServerKt"
+```
+
+### Production
+
+```bash
+# Build executable JAR
+mvn package
+
+# Run the JAR
+java -jar target/<%= 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 %>/target/<%= 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 %>/
+├── pom.xml                           # Maven configuration
+├── src/
+│   └── main/
+│       ├── kotlin/
+│       │   └── com/example/mcp/
+│       │       └── McpServer.kt      # Main server file
+│       └── resources/
+│           └── logback.xml           # Logging configuration
+├── .gitignore
+├── .env.example
+└── README.md
+```
+
+## License
+
+MIT

package/templates/kotlin/maven/pom.xml.ejs

@@ -0,0 +1,105 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>com.example</groupId>
+    <artifactId><%= name %></artifactId>
+    <version>1.0.0</version>
+    <packaging>jar</packaging>
+
+    <name><%= name %></name>
+    <description><%= description || 'MCP Server generated by mcp-new' %></description>
+
+    <properties>
+        <kotlin.version>1.9.22</kotlin.version>
+        <maven.compiler.source>17</maven.compiler.source>
+        <maven.compiler.target>17</maven.compiler.target>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <mcp.sdk.version>0.8.0</mcp.sdk.version>
+    </properties>
+
+    <dependencies>
+        <!-- Kotlin -->
+        <dependency>
+            <groupId>org.jetbrains.kotlin</groupId>
+            <artifactId>kotlin-stdlib</artifactId>
+            <version>${kotlin.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.jetbrains.kotlinx</groupId>
+            <artifactId>kotlinx-coroutines-core</artifactId>
+            <version>1.7.3</version>
+        </dependency>
+
+        <!-- MCP SDK -->
+        <dependency>
+            <groupId>io.modelcontextprotocol</groupId>
+            <artifactId>sdk</artifactId>
+            <version>${mcp.sdk.version}</version>
+        </dependency>
+
+        <!-- Logging -->
+        <dependency>
+            <groupId>org.slf4j</groupId>
+            <artifactId>slf4j-api</artifactId>
+            <version>2.0.9</version>
+        </dependency>
+        <dependency>
+            <groupId>ch.qos.logback</groupId>
+            <artifactId>logback-classic</artifactId>
+            <version>1.4.14</version>
+        </dependency>
+
+        <!-- JSON processing -->
+        <dependency>
+            <groupId>com.fasterxml.jackson.module</groupId>
+            <artifactId>jackson-module-kotlin</artifactId>
+            <version>2.16.1</version>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <sourceDirectory>src/main/kotlin</sourceDirectory>
+        <plugins>
+            <plugin>
+                <groupId>org.jetbrains.kotlin</groupId>
+                <artifactId>kotlin-maven-plugin</artifactId>
+                <version>${kotlin.version}</version>
+                <executions>
+                    <execution>
+                        <id>compile</id>
+                        <phase>compile</phase>
+                        <goals>
+                            <goal>compile</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+
+            <!-- Create executable JAR with dependencies -->
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-shade-plugin</artifactId>
+                <version>3.5.1</version>
+                <executions>
+                    <execution>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>shade</goal>
+                        </goals>
+                        <configuration>
+                            <transformers>
+                                <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
+                                    <mainClass>com.example.mcp.McpServerKt</mainClass>
+                                </transformer>
+                            </transformers>
+                            <createDependencyReducedPom>false</createDependencyReducedPom>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>