mcp-new 1.2.1 → 1.5.0

package/templates/elixir/README.md.ejs

@@ -0,0 +1,154 @@
+# <%= name %>
+
+<%= description || 'MCP Server generated by mcp-new' %>
+
+## Prerequisites
+
+- Elixir 1.15 or higher
+- Erlang/OTP 25 or higher
+
+## Installation
+
+```bash
+# Install dependencies
+mix deps.get
+
+# Compile
+mix compile
+```
+
+## Running the Server
+
+### Development
+
+```bash
+# Run in interactive mode
+iex -S mix
+
+# Or run directly
+mix run --no-halt
+```
+
+### Production
+
+```bash
+# Build release
+MIX_ENV=prod mix release
+
+# Or build escript
+mix escript.build
+
+# Run escript
+./<%= packageName %>
+```
+
+## 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": "mix",
+      "args": ["run", "--no-halt"],
+      "cwd": "/path/to/<%= name %>"
+    }
+  }
+}
+```
+
+Or with escript:
+
+```json
+{
+  "mcpServers": {
+    "<%= name %>": {
+      "command": "/path/to/<%= name %>/<%= packageName %>"
+    }
+  }
+}
+```
+
+## 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 %>/
+├── mix.exs                           # Project configuration
+├── config/
+│   ├── config.exs                    # Base configuration
+│   ├── dev.exs                       # Development config
+│   └── prod.exs                      # Production config
+├── lib/
+│   ├── application.ex                # Application entry point
+│   ├── server.ex                     # MCP Server implementation
+│   └── cli.ex                        # CLI entry point
+├── .gitignore
+├── .env.example
+└── README.md
+```
+
+## Development
+
+### Adding a New Tool
+
+1. Open `lib/server.ex`
+2. Add a new tool to the `register_tools` function:
+
+```elixir
+%{
+  name: "my_new_tool",
+  description: "Description of my tool",
+  input_schema: %{
+    type: "object",
+    properties: %{
+      param1: %{
+        type: "string",
+        description: "Parameter description"
+      }
+    },
+    required: ["param1"]
+  },
+  handler: &handle_my_new_tool/1
+}
+```
+
+3. Add the handler function:
+
+```elixir
+defp handle_my_new_tool(%{"param1" => param1}) do
+  # Your tool logic here
+  {:ok, %{
+    content: [
+      %{type: "text", text: "Result: #{param1}"}
+    ]
+  }}
+end
+```
+
+## License
+
+MIT

package/templates/elixir/config/config.exs.ejs

@@ -0,0 +1,9 @@
+import Config
+
+config :logger,
+  level: :info,
+  format: "$time $metadata[$level] $message\n",
+  metadata: [:request_id]
+
+# Import environment specific config
+import_config "#{config_env()}.exs"

package/templates/elixir/config/dev.exs.ejs

@@ -0,0 +1,3 @@
+import Config
+
+config :logger, level: :debug

package/templates/elixir/config/prod.exs.ejs

@@ -0,0 +1,3 @@
+import Config
+
+config :logger, level: :info

package/templates/elixir/lib/application.ex.ejs

@@ -0,0 +1,19 @@
+defmodule <%= namespace %>.Application do
+  @moduledoc """
+  <%= name %> MCP Server Application
+  <%= description || 'Generated by mcp-new' %>
+  """
+
+  use Application
+  require Logger
+
+  @impl true
+  def start(_type, _args) do
+    children = [
+      {<%= namespace %>.Server, []}
+    ]
+
+    opts = [strategy: :one_for_one, name: <%= namespace %>.Supervisor]
+    Supervisor.start_link(children, opts)
+  end
+end

package/templates/elixir/lib/cli.ex.ejs

@@ -0,0 +1,17 @@
+defmodule <%= namespace %>.CLI do
+  @moduledoc """
+  CLI entry point for <%= name %> MCP Server
+  """
+
+  require Logger
+
+  def main(_args) do
+    Logger.info("<%= name %> MCP server running on stdio")
+    
+    # Start the application
+    Application.ensure_all_started(:<%= packageName %>)
+    
+    # Keep the process alive
+    Process.sleep(:infinity)
+  end
+end

package/templates/elixir/lib/server.ex.ejs

@@ -0,0 +1,112 @@
+defmodule <%= namespace %>.Server do
+  @moduledoc """
+  MCP Server implementation for <%= name %>
+  """
+
+  use GenServer
+  require Logger
+
+  def start_link(opts \\ []) do
+    GenServer.start_link(__MODULE__, opts, name: __MODULE__)
+  end
+
+  @impl true
+  def init(_opts) do
+    Logger.info("<%= name %> MCP server starting...")
+    
+    # Register tools
+    tools = register_tools()
+    
+    {:ok, %{tools: tools}}
+  end
+
+  defp register_tools do
+    [
+<% if (includeExampleTool) { %>
+      %{
+        name: "example_tool",
+        description: "An example tool that echoes the input",
+        input_schema: %{
+          type: "object",
+          properties: %{
+            query: %{
+              type: "string",
+              description: "The query to echo"
+            }
+          },
+          required: ["query"]
+        },
+        handler: &handle_example_tool/1
+      },
+<% } %>
+<% tools.forEach(function(tool) { %>
+      %{
+        name: "<%= tool.name %>",
+        description: "<%= tool.description %>",
+        input_schema: %{
+          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(', ') %>]
+        },
+        handler: &handle_<%= tool.name %>/1
+      },
+<% }); %>
+    ]
+  end
+
+<% if (includeExampleTool) { %>
+  defp handle_example_tool(%{"query" => query}) do
+    {:ok, %{
+      content: [
+        %{type: "text", text: "Echo: #{query}"}
+      ]
+    }}
+  end
+<% } %>
+
+<% tools.forEach(function(tool) { %>
+  defp handle_<%= tool.name %>(args) do
+    # TODO: Implement <%= tool.name %> logic
+<% tool.parameters.forEach(function(param) { %>
+    _<%= param.name %> = Map.get(args, "<%= param.name %>")
+<% }); %>
+
+    {:ok, %{
+      content: [
+        %{type: "text", text: "<%= tool.name %> called with: #{inspect(args)}"}
+      ]
+    }}
+  end
+<% }); %>
+
+  # Handle incoming MCP messages
+  @impl true
+  def handle_info({:mcp, :list_tools}, state) do
+    tools = Enum.map(state.tools, fn tool ->
+      %{
+        name: tool.name,
+        description: tool.description,
+        inputSchema: tool.input_schema
+      }
+    end)
+    
+    {:noreply, state, {:reply, %{tools: tools}}}
+  end
+
+  @impl true
+  def handle_info({:mcp, :call_tool, name, arguments}, state) do
+    result = case Enum.find(state.tools, fn t -> t.name == name end) do
+      nil -> {:error, "Unknown tool: #{name}"}
+      tool -> tool.handler.(arguments)
+    end
+    
+    {:noreply, state, {:reply, result}}
+  end
+end

package/templates/elixir/mix.exs.ejs

@@ -0,0 +1,32 @@
+defmodule <%= namespace %>.MixProject do
+  use Mix.Project
+
+  def project do
+    [
+      app: :<%= packageName %>,
+      version: "1.0.0",
+      elixir: "~> 1.15",
+      start_permanent: Mix.env() == :prod,
+      deps: deps(),
+      escript: escript()
+    ]
+  end
+
+  def application do
+    [
+      extra_applications: [:logger],
+      mod: {<%= namespace %>.Application, []}
+    ]
+  end
+
+  defp deps do
+    [
+      {:mcp, "~> 0.1.0"},
+      {:jason, "~> 1.4"}
+    ]
+  end
+
+  defp escript do
+    [main_module: <%= namespace %>.CLI]
+  end
+end

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

@@ -0,0 +1,48 @@
+# 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
+
+# Gradle
+.gradle/
+build/
+gradle-app.setting
+!gradle-wrapper.jar
+.gradletasknamecache
+
+# IDE
+.idea/
+*.iml
+*.ipr
+*.iws
+.project
+.classpath
+.settings/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Environment
+.env
+.env.local

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 %>'