Koan MCP Integration

Core Principle

Expose Koan services as MCP tools for Claude integration. Use framework patterns for tool implementations.

MCP Server Setup

Basic MCP Server

using Koan.Mcp;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddKoan();
builder.Services.AddKoanMcp(); // Adds MCP capabilities
var app = builder.Build();
app.Run();

Expose Entity as MCP Tool

public class TodoMcpTool : IMcpTool
{
    public string Name => "get_todo";
    public string Description => "Retrieve a todo by ID";

    public McpToolSchema Schema => new()
    {
        Parameters = new[]
        {
            new McpParameter { Name = "id", Type = "string", Required = true }
        }
    };

    public async Task<McpToolResult> ExecuteAsync(
        Dictionary<string, object> args,
        CancellationToken ct)
    {
        var id = args["id"].ToString();
        var todo = await Todo.Get(id, ct);

        return new McpToolResult
        {
            Content = todo != null
                ? $"Todo: {todo.Title} (Completed: {todo.Completed})"
                : "Todo not found"
        };
    }
}

Configuration

{
  "Koan": {
    "Mcp": {
      "ServerName": "Todo MCP Server",
      "Version": "1.0.0",
      "Transport": "stdio",
      "Capabilities": {
        "Tools": true,
        "Resources": true,
        "Prompts": false
      }
    }
  }
}

Code Mode Integration

MCP servers integrate with Claude Code Mode for enhanced capabilities.

When This Skill Applies

• ✅ Building MCP servers
• ✅ Claude integrations
• ✅ Tool development
• ✅ MCP Code Mode

Reference Documentation

• Guide: docs/guides/mcp-http-sse-howto.md
• Sample: samples/S16.PantryPal/MCP/ (MCP server example)
• Module: src/Koan.Mcp/