koan-mcp-integration

What problem does it solve?

Integrating custom application logic and data with AI models like Claude often requires complex API wrappers and manual orchestration. This Skill simplifies exposing Koan services as Machine-Code Protocol (MCP) tools, enabling seamless interaction with Claude's Code Mode.

Core Features & Use Cases

• MCP Server Setup: Easily configure your Koan application to act as an MCP server, ready to receive tool calls from AI.
• Expose Entities as Tools: Turn your existing Koan entities and business logic into callable AI tools with defined schemas.
• Code Mode Integration: Leverage Claude's Code Mode to execute your Koan-backed tools, allowing the AI to interact with your application's data and functionality.
• Use Case: Create an IMcpTool that allows Claude to "get_todo" by ID, enabling the AI to retrieve and provide information about tasks directly from your Koan application.

Quick Start

1. Add MCP capabilities to your Program.cs: using Koan.Mcp; builder.Services.AddKoan(); builder.Services.AddKoanMcp();
2. Define an MCP tool for your 'Todo' entity: 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) { var id = args["id"].ToString(); var todo = await Todo.Get(id); return new McpToolResult { Content = todo != null ? $"Todo: {todo.Title}" : "Todo not found" }; } }