Qilin MCP Framework 🌩️🐲🌩️

What is Qilin MCP Framework?

Qilin MCP Framework is a Go library for building servers that implement the Model Context Protocol (MCP). It helps developers define tools and resources that large language models can discover and invoke. The framework is currently a work in progress.

How to use Qilin MCP Framework?

Install with go get github.com/miyamo2/qilin (requires Go 1.24+). In your code, create a new qilin instance, define tools using q.Tool() and resources using q.Resource(), then call q.Start() to listen and serve on stdio. The README provides a complete example of a calculator tool server.

Key features of Qilin MCP Framework

• Written in Go (requires Go 1.24+)
• Stdio transport (SSE transport planned but not yet supported)
• Tool listing and calling with middleware support
• Resource listing and reading with middleware support
• Resource templates and list‑changed notifications
• Resource subscriptions are not yet implemented

Use cases of Qilin MCP Framework

• Build a custom calculator server for an MCP‑aware AI assistant
• Expose existing Go functions as callable tools via MCP
• Serve dynamic resource templates (e.g., user‑specific data) to language models
• Create a middleware layer for logging, validation, or error handling on tool/resource calls

FAQ from Qilin MCP Framework

What is the minimum Go version required?

Go 1.24 or later is required.

Which MCP transports does Qilin support?

Currently only the Stdio transport is supported. SSE support is planned but not yet implemented.

What MCP features are currently available?

Tools (listing, calling with middleware) and resources (listing, reading with middleware, templates, and list‑changed notifications) are supported. Resource subscriptions are not yet implemented.

Is Qilin production‑ready?

No, the framework is still a work in progress and marked with a 🚧WIP🚧 warning.

What license does Qilin use?

The project is licensed under the MIT License (as shown in the repository badge).