Keerukee.MCPServer.Stdio 1.0.2

MCPServer

A lightweight .NET library for building MCP (Model Context Protocol) servers without external dependencies. Simply decorate your methods with attributes and the library handles all the protocol communication.

Features

• Zero external dependencies - Uses only built-in .NET libraries
• Attribute-based registration - Decorate methods with [McpTool], [McpResource], or [McpPrompt]
• Automatic discovery - Tools, resources, and prompts are discovered via reflection
• JSON Schema generation - Input schemas are automatically generated from method parameters
• Full MCP compliance - Supports all standard MCP methods for client compatibility

Installation

Add a reference to the MCPServer project:

<ItemGroup>
  <ProjectReference Include="..\MCPServer\MCPServer.csproj" />
</ItemGroup>

Or if published as a NuGet package:

<ItemGroup>
  <PackageReference Include="MCPServer" Version="1.0.0" />
</ItemGroup>

Quick Start

1. Create the Server Entry Point

using MCPServer;

var server = new McpServerHost(new McpServerOptions
{
    ServerName = "MyMCPServer",
    ServerVersion = "1.0.0"
});

server.Run();

2. Add Tools

Create a class with static methods decorated with [McpTool]:

using MCPServer.Attributes;

public static class MyTools
{
    [McpTool("greet", "Greets a person by name")]
    public static string Greet(
        [McpParameter("The name of the person to greet")] string name)
    {
        return $"Hello, {name}!";
    }

    [McpTool("calculate_sum", "Adds two numbers together")]
    public static string CalculateSum(
        [McpParameter("First number")] double a,
        [McpParameter("Second number")] double b)
    {
        return $"The sum is {a + b}";
    }
}

3. Add Resources (Optional)

Resources provide read-only data to clients:

using MCPServer.Attributes;

public static class MyResources
{
    [McpResource("config://app", "App Configuration", "Returns application configuration", "application/json")]
    public static string GetAppConfig()
    {
        return """{"version": "1.0.0", "environment": "production"}""";
    }
}

4. Add Prompts (Optional)

Prompts are reusable prompt templates:

using MCPServer.Attributes;

public static class MyPrompts
{
    [McpPrompt("code_review", "Generates a code review prompt")]
    public static string CodeReviewPrompt(
        [McpParameter("Programming language")] string language,
        [McpParameter("Code to review")] string code)
    {
        return $"Please review this {language} code:\n```{language}\n{code}\n```";
    }
}

Attributes Reference

[McpTool(name, description)]

Marks a static method as an MCP tool.

[McpParameter(description, required)]

Adds metadata to method parameters.

[McpResource(uri, name, description, mimeType)]

Marks a static method as an MCP resource.

[McpResourceTemplate(uriTemplate, name, description, mimeType)]

Marks a static method as an MCP resource template.

[McpPrompt(name, description)]

Marks a static method as an MCP prompt.

Server Configuration

var server = new McpServerHost(new McpServerOptions
{
    ServerName = "MyServer",           // Name shown to clients
    ServerVersion = "1.0.0",           // Your server version
    ProtocolVersion = "2024-11-05"     // MCP protocol version
});

Supported Parameter Types

The library automatically converts JSON values to these C# types:

MCP Client Configuration

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "my-server": {
      "command": "dotnet",
      "args": ["run", "--project", "path/to/your/project.csproj"]
    }
  }
}

Or if using a compiled executable:

{
  "mcpServers": {
    "my-server": {
      "command": "path/to/your/server.exe"
    }
  }
}

VS Code / Continue

Add to your MCP configuration:

{
  "servers": {
    "my-server": {
      "command": "dotnet",
      "args": ["path/to/your/server.dll"]
    }
  }
}

Supported MCP Methods

Example Project Structure

MyMCPServer/
├── MyMCPServer.csproj
├── Program.cs
└── Features/
    ├── Tools.cs
    ├── Resources.cs
    └── Prompts.cs

License

Keerthi RB