Qilin MCP Framework 🌩️🐲🌩️

Qilin 🌩️🐲🌩️ – Go 向け Model Context Protocol フレームワーク

🌟 主な特徴

⚡ 設定不要のサーバー	qilin.New().Start() で、STDIN/STDOUT 上で MCP サーバーを起動できます
🤝 おなじみの操作感	Go のよく知られた Web アプリケーションフレームワークに着想を得たハンドラーです。これらに慣れた開発者なら、すぐに使いこなせます。
⏩ ストリーミング可能な HTTP	ストリーミング可能な HTTP トランスポートをサポートします。

🚀 クイックスタート

go get github.com/miyamo2/qilin

package main

import (
	"fmt"
	"github.com/miyamo2/qilin"
	"maps"
)

type OrderBeerRequest struct {
	BeerName string `json:"beer_name" jsonschema:"title=Beer Name"`
	Quantity int    `json:"quantity"  jsonschema:"title=Quantity of Beers"`
}

type OrderBeerResponse struct {
	Amount float64 `json:"amount"`
}

var beers = map[string]string{
	"IPA":   "A hoppy beer with a bitter finish.",
	"Stout": "A dark beer with a rich, roasted flavor.",
	"Lager": "A light, crisp beer with a smooth finish.",
}

func main() {
	q := qilin.New("beer hall", qilin.WithVersion("v0.1.0"))

	q.Resource("menu_list",
		"resources://beer_list",
		func(c qilin.ResourceContext) error {
			return c.JSON(maps.Keys(beers))
		})

	q.Tool("order_beer",
		(*OrderBeerRequest)(nil),
		func(c qilin.ToolContext) error {
			var req OrderBeerRequest
			if err := c.Bind(&req); err != nil {
				return err
			}
			_, ok := beers[req.BeerName]
			if !ok {
				return fmt.Errorf("beer %s not found", req.BeerName)
			}
			amount := 8 * req.Quantity // Assume unit cost of all beers is $8.00.
			return c.JSON(OrderBeerResponse{Amount: float64(amount)})
		})
	q.Start() // listen on stdio
}

詳しい使い方については、Qilin ユーザーガイドを参照してください。

🛤 ロードマップ

トランスポート

• Stdio
• ストリーミング可能な HTTP

機能

• ツール
  • 一覧表示
  • 呼び出し
    • ミドルウェア
• リソース
  • 一覧表示
  • 読み取り
    • ミドルウェア
  • テンプレート
  • 一覧変更通知
  • サブスクリプション
• プロンプト

📜 ライセンス

Qilin はMIT ライセンスのもとで公開されています