mcpkit

MCPKit

Production-grade MCP (Model Context Protocol) server and client library for Go.

Quick Start

import (
    "context"
    "github.com/panyam/mcpkit/core"
    "github.com/panyam/mcpkit/server"
)

srv := server.NewServer(
    core.ServerInfo{Name: "my-server", Version: "0.1.0"},
    server.WithToolTimeout(30 * time.Second),
)

srv.RegisterTool(core.ToolDef{
    Name: "greet", Description: "Say hello",
    InputSchema: map[string]any{"type": "object", "properties": map[string]any{"name": map[string]any{"type": "string"}}},
}, func(ctx context.Context, req core.ToolRequest) (core.ToolResult, error) {
    var args struct{ Name string `json:"name"` }
    req.Bind(&args)
    return core.TextResult("Hello, " + args.Name + "!"), nil
})

srv.Run(":8787") // Streamable HTTP

Packages

Conformance

30/30 server scenarios, 14/14 auth scenarios passing against the official MCP conformance suite.

Testing

make test          # Unit tests (200+ across core/server/client)
make testall       # ALL tests + Keycloak + conformance + HTML report
make testconf      # MCP conformance suite
make testconfauth  # Auth conformance

Documentation

Dependencies

• servicekit v0.0.14 — SSE hub, graceful shutdown
• oneauth v0.0.64 — JWT/OIDC (only via ext/auth sub-module)