Go MCP

🚀 Go言語MCPプロトコルライブラリ

このライブラリは、モデルコンテキストプロトコル（Model Context Protocol、略称MCP）を実装するためのGo言語用のライブラリです。このプロトコルは、AIモデルと外部とのやり取りの標準インターフェースを定義し、テキスト、画像、音声などの様々なコンテンツタイプの操作をサポートしています。

🚀 クイックスタート

なぜMCPを選ぶのか？

• 統一標準：最新の2025-03-26 MCP仕様に基づいて開発されています。
• 機能豊富：プロンプト、ツール呼び出し、リソース操作などの核心機能をサポートしています。
• 拡張性が高い：複数のメディアタイプとリソース形式をサポートする機能が組み込まれています。
• 高効率かつ信頼性高い：非同期非ブロッキングアーキテクチャを採用しており、パフォーマンスが大幅に最適化されています。

プロトコルの更新

新機能

• 完全なJSON RPCサポート
• マルチモーダルコンテンツの転送機能
• ページングクエリ機能
• リソーステンプレートシステム
• リソース購読通知
• 詳細なサーバ宣言型機能
• 統一されたレスポンス処理メカニズム

📦 インストール

go get github.com/your-organization/mcp-go

💻 使用例

基本的な使用法

サーバーの作成

// 创建服务
server, err := mcp.NewServer(service, &types.ServerOptions{
    Address: ":8080",
    Capabilities: &types.ServerCapabilities{
        Prompts: &types.PromptCapabilities{
            ListChanged: true,
        },
        Resources: &types.ResourceCapabilities{
            ListChanged: true,
            Subscribe: true,
            Templates: true,
        },
    },
})

クライアントの作成

// 创建客户端
client, err := mcp.NewClient(&types.ClientOptions{
    ServerAddress: "localhost:8080",
    Type: "http",
    UseJSONRPC: true,
    SubscribeToNotifications: true,
})

高度な使用法

サーバーインターフェース

サービスはtypes.Serverインターフェースを実装する必要があります。

type Server interface {
    MCPService
    Initialize(ctx context.Context, options any) error
    Start() error
    Shutdown(ctx context.Context) error
}

核心機能はMCPServiceインターフェースによって定義されます。

type MCPService interface {
    // 列出所有提示词，支持分页查询
    ListPrompts(ctx context.Context, cursor string) (*PromptListResult, error)
    
    // 获取特定提示词内容，可指定参数
    GetPrompt(ctx context.Context, name string, args map[string]any) (*PromptResult, error)

    // 列出所有工具，支持分页查询
    ListTools(ctx context.Context, cursor string) (*ToolListResult, error)

    // 调用特定工具，可指定参数
    CallTool(ctx context.Context, name string, args map[string]any) (*CallToolResult, error)

    // 列出所有资源，支持分页查询
    ListResources(ctx context.Context, cursor string) (*ResourceListResult, error)

    // 读取特定资源内容
    ReadResource(ctx context.Context, uri string) (*ResourceContent, error)

    // 获取资源模板列表
    ListResourceTemplates(ctx context.Context) ([]ResourceTemplate, error)

    // 订阅特定资源的变更通知
    SubscribeResource(ctx context.Context, resourceID string, callback func(*ResourceUpdateEvent)) error)
}

クライアントインターフェース

type MCPClient interface {
    // 发送提示词请求
    SendPrompt(prompt *Prompt) (*Response, error)

    // 调用工具方法
    CallTool(toolName string, args map[string]any) (*Response, error)

    // 订阅资源更新通知
    SubscribeResource(resourceID string, callback func(*ResourceUpdateEvent)) error)
}

エラー処理

type MCPError struct {
    Code    int    `json:"code"`
    Message string `json:"message"`
}

func (e *MCPError) Error() string {
    return e.Message
}

プロンプト操作の使用例

prompt := &Prompt{
    Content: "帮我写一首诗",
    Parameters: map[string]string{
        "temperature": "0.7",
    },
}

response, err := client.SendPrompt(prompt)
if err != nil {
    // 处理错误
}

ツール呼び出しの使用例

toolResult, err := client.CallTool("image_generator", map[string]string{
    "prompt": "一片孤帆远影碧空尽",
})
if err != nil {
    // 处理错误
}

📚 ドキュメント

貢献ガイド

• コード規約：Google Go言語スタイルガイドに従ってください。
• 単体テストのカバレッジは100%に達する必要があります。
• PRを提出する前に、CIチェックを通過する必要があります。
• GitHubの貢献契約書に従ってください。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されており、自由に使用および変更することができます。

詳細なドキュメントについては、公式ドキュメントを参照してください。