MCP Golang

🚀 Go言語で実装されたMCPサーバーのクライアントとサーバー機能の詳細

このプロジェクトは、Go言語を使用してMCPサーバーのクライアントとサーバー機能を実装しており、クライアントとサーバー間の双方向通信を実現しています。

✨ 主な機能

クライアントとサーバーの双方向通信の実現

ツール呼び出し

• 機能説明：

  • ツール呼び出しをサポートしており、ユーザーは定義されたツールインターフェースを通じて機能を拡張できます。
  • ネイティブのGo構造体をパラメータとして使用することで、データ転送の安全性と型安全性を確保します。
  • プログラムによるツールリストエンドポイントの生成を提供し、クライアントが動的に利用可能なツール情報を取得できるようにします。
  • 変更通知メカニズムを実装し、クライアントがサーバーのツールの更新状況を即座に知ることができます。
  • ページング機能をサポートし、ツール数が多い場合の効率的なデータ管理に適しています。

• コアコード例：

package main

import (
    "context"
    "log"
    mcp "github.com/metoro-io/mcp-golang"
    "github.com/metoro-io/mcp-golang/transport/stdio"
)

// ツール呼び出しのパラメータ構造体を定義
type CalculateArgs struct {
    Operation string `json:"operation"`
    A         int    `json:"a"`
    B         int    `json:"b"`
}

func main() {
    // クライアントを作成して初期化
    transport := stdio.NewStdioServerTransport()
    client := mcp.NewClient(transport)

    if _, err := client.Initialize(context.Background()); err != nil {
        log.Fatalf("初期化に失敗しました: %v", err)
    }

    // ツール呼び出しの例
    args := CalculateArgs{
        Operation: "add",
        A:         10,
        B:         5,
    }
    
    response, err := client.CallTool(context.Background(), "calculate", args)
    if err != nil {
        log.Fatalf("ツールの呼び出しに失敗しました: %v", err)
    }

    if response != nil && len(response.Content) > 0 {
        log.Printf("結果: %s", response.Content[0].TextContent.Text)
    }
}

プロンプト呼び出し

• 機能説明：

  • プロンプト呼び出しをサポートしており、ユーザーは事前に設定されたプロンプトテンプレートを通じてサーバーとやり取りできます。
  • 同様にGo構造体をパラメータとして使用し、データの一貫性と安全性を確保します。
  • 自動的にプロンプトリストエンドポイントを生成し、クライアントが動的に利用可能なプロンプト情報を取得できるようにします。
  • 変更通知メカニズムを実装し、クライアントとサーバーの情報を同期させます。
  • ページング機能をサポートし、大量のプロンプトテンプレートの管理に適しています。

• コアコード例：

package main

import (
    "context"
    "log"
    mcp "github.com/metoro-io/mcp-golang"
    "github.com/metoro-io/mcp-golang/transport/stdio"
)

// プロンプト呼び出しのパラメータ構造体を定義
type QueryArgs struct {
    Keywords    []string `json:"keywords"`
    PageSize   int      `json:"page_size"`
    PageNumber int      `json:"page_number"`
}

func main() {
    transport := stdio.NewStdioServerTransport()
    client := mcp.NewClient(transport)

    if _, err := client.Initialize(context.Background()); err != nil {
        log.Fatalf("初期化に失敗しました: %v", err)
    }

    // プロンプト呼び出しの例
    args := QueryArgs{
        Keywords:    []string{"ビッグデータ", "分析"},
        PageSize:   10,
        PageNumber: 1,
    }
    
    response, err := client.CallPrompt(context.Background(), "data_analysis", args)
    if err != nil {
        log.Fatalf("プロンプトの呼び出しに失敗しました: %v", err)
    }

    if response != nil && len(response.Content) > 0 {
        log.Printf("結果: %s", response.Content[0].TextContent.Text)
    }
}

リソース管理

• 機能説明：

  • リソースの追加、削除、変更、検索操作をサポートし、ユーザーはさまざまな設定やデータを簡単に管理できます。
  • 自動的にリソースリストエンドポイントを生成し、クライアントが最新のリソース情報をリアルタイムで取得できるようにします。
  • 変更通知メカニズムを実装し、クライアントとサーバーのデータを同期させます。
  • ページング機能をサポートし、大量のリソースの効率的な管理に適しています。

• コアコード例：

package main

import (
    "context"
    "log"
    mcp "github.com/metoro-io/mcp-golang"
    "github.com/metoro-io/mcp-golang/transport/stdio"
)
// ここに元のコードが途中で途切れていましたが、そのまま残しておきます。

💻 使用例

基本的な使用法

上記の各機能のコード例を参考に、ツール呼び出し、プロンプト呼び出し、リソース管理などの機能を使用できます。それぞれのコード例では、クライアントの初期化、パラメータの設定、機能の呼び出し、結果の取得などの基本的な手順が示されています。