Go MCP

🚀 go-mcp 紹介

go-mcp は、MCP（モデルコンテキストプロトコル）サーバーを構築するための Go 言語用 SDK です。型安全性と直感的に使いやすいインターフェースを重視しています。

✨ 主な機能

• 型安全性：コード生成により、ツールとヒントパラメータを静的型付けし、コンパイル時にエラーを検出します。
• シンプルで直感的な API：自然で Go スタイルのインターフェースを提供し、学習曲線を低く抑えます。
• 開発者にやさしい：API の使いやすさに重点を置いています。

🚀 クイックスタート

ディレクトリ構造の例

プロジェクトのディレクトリ構造は次の通りです。

your-project/
  cmd/temperature/
    main.go
    handler.go
  cmd/mcpgen/
    main.go

サンプルコード

ステップ 1：MCP サーバーを定義する

mcpgen ツールを実行してコードを生成します。

go run ./cmd/mcpgen

ステップ 2：MCP サーバーのロジックを実装する

handler.go でロジックを実装します。例えば、温度変換ツールの場合：

package main

import (
	"context"
	"fmt"
	"math"
)

type toolHandler struct{}

func NewHandler(h *toolHandler) mcp.Handler {
	return mcp.HandlerFunc(func(ctx context.Context, req *mcp.Request) (*mcp.Response, error) {
		if req.IsPing() {
			return &mcp.Response{Id: req.Id}, nil
		}
		if req.IsCallTool() {
			content := req.GetCallTool().Content
			tool := content[0].GetTool()
			switch tool.ID {
			case "temperature-converter":
				fromUnit := string(tool.Params["from_unit"])
				toUnit := string(tool.Params["to_unit"])
				temp, err := tool.Params["temperature"].(float64)
				if err != nil {
					return nil, fmt.Errorf("invalid temperature value")
				}
				result := convertTemperature(temp, fromUnit, toUnit)
				return &mcp.Response{
					Id:    req.Id,
					Data:  mcp.NewData(map[string]interface{}{
						"result": result,
					}),
				}, nil
			default:
				return nil, fmt.Errorf("tool not found")
			}
		}
		return nil, nil
	})
}

func convertTemperature(value float64, fromUnit string, toUnit string) float64 {
	switch fromUnit {
	case "celsius":
		switch toUnit {
		case "fahrenheit":
			return (value * 9.0 / 5.0) + 32
		default:
			return value
		}
	case "fahrenheit":
		switch toUnit {
		case "celsius":
			return (value - 32) * 5.0 / 9.0
		default:
			return value
		}
	default:
		return value
	}
}

func main() {
	handler := NewHandler(new(toolHandler))
	server := mcp.NewServer(":8080", handler)
	if err := server.Start(); err != nil {
		fmt.Printf("Failed to start server: %v\n", err)
	}
}

ターミナルで以下のコマンドを実行してサーバーを起動します。

go run ./cmd/temperature/main.go

💻 使用例

Ping リクエストを送信する

curl コマンドを使用して Ping リクエストを送信します。

curl -X POST http://localhost:8080/ping

温度変換ツールを呼び出す

事前に定義された "temperature-converter" ツールを呼び出します。

curl -X POST http://localhost:8080/call_tool \
  --data '{"tool_id":"temperature-converter","params":{"from_unit":"celsius","to_unit":"fahrenheit","temperature":32}}'

ツールリストを表示する

登録されているすべてのツールをリスト表示します。

curl -X GET http://localhost:8080/tools

📚 ドキュメント

サポートされている機能

• Ping：サーバーの接続性を検証します。
• Tools：ツールの登録と呼び出しを管理します。
• Prompts：ユーザーのヒントリクエストを処理します。

その他の機能については、プロジェクトのドキュメントを参照してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。詳細は LICENSE ファイルを参照してください。