mcp-new 1.2.2 → 1.5.0

package/templates/csharp/README.md.ejs

@@ -0,0 +1,136 @@
+# <%= name %>
+
+<%= description || 'MCP Server generated by mcp-new' %>
+
+## Prerequisites
+
+- .NET 8.0 SDK or higher
+
+## Installation
+
+```bash
+# Restore dependencies
+dotnet restore
+
+# Build
+dotnet build
+```
+
+## Running the Server
+
+### Development
+
+```bash
+dotnet run
+```
+
+### Production
+
+```bash
+# Build release version
+dotnet publish -c Release -o publish
+
+# Run
+./publish/<%= name %>
+```
+
+## 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": "dotnet",
+      "args": ["run", "--project", "/path/to/<%= name %>"]
+    }
+  }
+}
+```
+
+Or with published binary:
+
+```json
+{
+  "mcpServers": {
+    "<%= name %>": {
+      "command": "/path/to/<%= name %>/publish/<%= name %>"
+    }
+  }
+}
+```
+
+## 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 %>/
+├── <%= name %>.csproj               # Project file
+├── src/
+│   └── Program.cs                    # Main server file
+├── .gitignore
+├── .env.example
+└── README.md
+```
+
+## Development
+
+### Adding a New Tool
+
+1. Open `src/Program.cs`
+2. Add a new tool registration in the `RegisterTools` method:
+
+```csharp
+services.AddMcpTool("my_new_tool", "Description of my tool", async (args, cancellationToken) =>
+{
+    var param1 = args.GetProperty("param1").GetString();
+    // Your tool logic here
+    return new ToolResult
+    {
+        Content = new[]
+        {
+            new TextContent { Text = $"Result: {param1}" }
+        }
+    };
+},
+new ToolInputSchema
+{
+    Type = "object",
+    Properties = new Dictionary<string, ToolPropertySchema>
+    {
+        ["param1"] = new ToolPropertySchema
+        {
+            Type = "string",
+            Description = "Parameter description"
+        }
+    },
+    Required = new[] { "param1" }
+});
+```
+
+## License
+
+MIT

package/templates/csharp/src/Program.cs.ejs

@@ -0,0 +1,117 @@
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Hosting;
+using Microsoft.Extensions.Logging;
+using ModelContextProtocol.Server;
+using System.Text.Json;
+
+namespace <%= namespace %>;
+
+/// <summary>
+/// <%= name %> MCP Server
+/// <%= description || 'Generated by mcp-new' %>
+/// </summary>
+class Program
+{
+    static async Task Main(string[] args)
+    {
+        var builder = Host.CreateApplicationBuilder(args);
+        
+        builder.Logging.AddConsole();
+        builder.Logging.SetMinimumLevel(LogLevel.Information);
+
+        builder.Services.AddMcpServer(options =>
+        {
+            options.ServerInfo = new ServerInfo
+            {
+                Name = "<%= name %>",
+                Version = "1.0.0"
+            };
+        });
+
+        // Register tools
+        RegisterTools(builder.Services);
+
+        var host = builder.Build();
+
+<% if (transport === 'stdio') { %>
+        // Start STDIO server
+        Console.Error.WriteLine("<%= name %> MCP server running on stdio");
+        await host.RunMcpServerAsync();
+<% } else { %>
+        // Start SSE server
+        Console.Error.WriteLine("<%= name %> MCP server running on SSE at http://localhost:8080");
+        await host.RunMcpSseServerAsync(8080);
+<% } %>
+    }
+
+    static void RegisterTools(IServiceCollection services)
+    {
+<% if (includeExampleTool) { %>
+        // Register example_tool
+        services.AddMcpTool("example_tool", "An example tool that echoes the input", async (args, cancellationToken) =>
+        {
+            var query = args.GetProperty("query").GetString() ?? "";
+            return new ToolResult
+            {
+                Content = new[]
+                {
+                    new TextContent { Text = $"Echo: {query}" }
+                }
+            };
+        },
+        new ToolInputSchema
+        {
+            Type = "object",
+            Properties = new Dictionary<string, ToolPropertySchema>
+            {
+                ["query"] = new ToolPropertySchema
+                {
+                    Type = "string",
+                    Description = "The query to echo"
+                }
+            },
+            Required = new[] { "query" }
+        });
+<% } %>
+
+<% tools.forEach(function(tool) { %>
+        // Register <%= tool.name %>
+        services.AddMcpTool("<%= tool.name %>", "<%= tool.description %>", async (args, cancellationToken) =>
+        {
+            // TODO: Implement <%= tool.name %> logic
+<% tool.parameters.forEach(function(param) { %>
+<% if (param.type === 'number') { %>
+            var <%= param.name %> = args.GetProperty("<%= param.name %>").GetDouble();
+<% } else if (param.type === 'boolean') { %>
+            var <%= param.name %> = args.GetProperty("<%= param.name %>").GetBoolean();
+<% } else { %>
+            var <%= param.name %> = args.GetProperty("<%= param.name %>").GetString();
+<% } %>
+<% }); %>
+
+            return new ToolResult
+            {
+                Content = new[]
+                {
+                    new TextContent { Text = $"<%= tool.name %> called with: {args}" }
+                }
+            };
+        },
+        new ToolInputSchema
+        {
+            Type = "object",
+            Properties = new Dictionary<string, ToolPropertySchema>
+            {
+<% tool.parameters.forEach(function(param, index) { %>
+                ["<%= param.name %>"] = new ToolPropertySchema
+                {
+                    Type = "<%= param.type %>",
+                    Description = "<%= param.description %>"
+                }<%= index < tool.parameters.length - 1 ? ',' : '' %>
+<% }); %>
+            },
+            Required = new[] { <%= tool.parameters.filter(p => p.required).map(p => '"' + p.name + '"').join(', ') %> }
+        });
+<% }); %>
+    }
+}

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

@@ -0,0 +1,33 @@
+# Dependencies
+/deps/
+/_build/
+/cover/
+/doc/
+
+# Dialyzer
+/priv/plts/
+
+# Generated files
+*.beam
+*.ez
+erl_crash.dump
+
+# Release
+/rel/
+
+# IDE
+.idea/
+*.iml
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Environment
+.env
+.env.local
+*.secret.exs

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