mcp-new 1.2.2 → 1.5.0

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

@@ -0,0 +1,132 @@
+# <%= name %>
+
+<%= description || 'MCP Server generated by mcp-new' %>
+
+## Prerequisites
+
+- Java 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                      # Gradle configuration
+├── settings.gradle                   # Project settings
+├── src/
+│   └── main/
+│       ├── java/
+│       │   └── com/example/mcp/
+│       │       └── McpServer.java    # Main server file
+│       └── resources/
+│           └── logback.xml           # Logging configuration
+├── .gitignore
+├── .env.example
+└── README.md
+```
+
+## Development
+
+### Adding a New Tool
+
+1. Open `src/main/java/com/example/mcp/McpServer.java`
+2. Add a new tool registration in the `registerTools` method:
+
+```java
+server.addTool(
+    McpSchema.Tool.builder()
+        .name("my_new_tool")
+        .description("Description of my tool")
+        .inputSchema(createInputSchema(
+            Map.of("param1", Map.of(
+                "type", "string",
+                "description", "Parameter description"
+            )),
+            List.of("param1")  // required parameters
+        ))
+        .build(),
+    (request) -> {
+        String param1 = (String) request.getArguments().get("param1");
+        // Your tool logic here
+        return McpSchema.CallToolResult.builder()
+            .content(List.of(
+                McpSchema.TextContent.builder()
+                    .type("text")
+                    .text("Result: " + param1)
+                    .build()
+            ))
+            .build();
+    }
+);
+```
+
+## License
+
+MIT

package/templates/java/gradle/build.gradle.ejs

@@ -0,0 +1,46 @@
+plugins {
+    id 'java'
+    id 'application'
+    id 'com.github.johnrengelman.shadow' version '8.1.1'
+}
+
+group = 'com.example'
+version = '1.0.0'
+
+java {
+    sourceCompatibility = JavaVersion.VERSION_17
+    targetCompatibility = JavaVersion.VERSION_17
+}
+
+repositories {
+    mavenCentral()
+}
+
+dependencies {
+    // MCP SDK
+    implementation 'io.modelcontextprotocol:sdk:0.8.0'
+
+    // Logging
+    implementation 'org.slf4j:slf4j-api:2.0.9'
+    implementation 'ch.qos.logback:logback-classic:1.4.14'
+
+    // JSON processing
+    implementation 'com.fasterxml.jackson.core:jackson-databind:2.16.1'
+}
+
+application {
+    mainClass = 'com.example.mcp.McpServer'
+}
+
+shadowJar {
+    archiveBaseName.set('<%= name %>')
+    archiveClassifier.set('')
+    archiveVersion.set('1.0.0')
+    manifest {
+        attributes 'Main-Class': 'com.example.mcp.McpServer'
+    }
+}
+
+tasks.named('build') {
+    dependsOn shadowJar
+}

package/templates/java/gradle/settings.gradle.ejs

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

package/templates/java/gradle/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/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/java/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/java/maven/.gitignore.ejs

@@ -0,0 +1,53 @@
+# Compiled class files
+*.class
+
+# Log files
+*.log
+
+# BlueJ files
+*.ctxt
+
+# Mobile Tools for Java (J2ME)
+.mtj.tmp/
+
+# 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
+
+# IDE
+.idea/
+*.iml
+*.ipr
+*.iws
+.project
+.classpath
+.settings/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Environment
+.env
+.env.local

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

@@ -0,0 +1,131 @@
+# <%= name %>
+
+<%= description || 'MCP Server generated by mcp-new' %>
+
+## Prerequisites
+
+- Java 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.McpServer"
+```
+
+### 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/
+│       ├── java/
+│       │   └── com/example/mcp/
+│       │       └── McpServer.java    # Main server file
+│       └── resources/
+│           └── logback.xml           # Logging configuration
+├── .gitignore
+├── .env.example
+└── README.md
+```
+
+## Development
+
+### Adding a New Tool
+
+1. Open `src/main/java/com/example/mcp/McpServer.java`
+2. Add a new tool registration in the `registerTools` method:
+
+```java
+server.addTool(
+    McpSchema.Tool.builder()
+        .name("my_new_tool")
+        .description("Description of my tool")
+        .inputSchema(createInputSchema(
+            Map.of("param1", Map.of(
+                "type", "string",
+                "description", "Parameter description"
+            )),
+            List.of("param1")  // required parameters
+        ))
+        .build(),
+    (request) -> {
+        String param1 = (String) request.getArguments().get("param1");
+        // Your tool logic here
+        return McpSchema.CallToolResult.builder()
+            .content(List.of(
+                McpSchema.TextContent.builder()
+                    .type("text")
+                    .text("Result: " + param1)
+                    .build()
+            ))
+            .build();
+    }
+);
+```
+
+## License
+
+MIT

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

@@ -0,0 +1,86 @@
+<?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>
+        <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>
+        <!-- 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.core</groupId>
+            <artifactId>jackson-databind</artifactId>
+            <version>2.16.1</version>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <version>3.11.0</version>
+                <configuration>
+                    <source>17</source>
+                    <target>17</target>
+                </configuration>
+            </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.McpServer</mainClass>
+                                </transformer>
+                            </transformers>
+                            <createDependencyReducedPom>false</createDependencyReducedPom>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>