Model Context Protocol (mcp) Implementation In Go

🚀 モデルコンテキストプロトコル（MCP）のGo言語による実装

このリポジトリは、大規模言語モデル（LLM）アプリケーションにおけるクライアントとサーバー間の通信に使用されるJSON - RPCベースのプロトコルのGo言語実装を含んでいます。このプロトコルはModel Context Protocol (MCP)と呼ばれ、LLMの機能強化を目的としています。

✨ 主な機能

• 大規模言語モデル（LLM）アプリケーションにおけるクライアントとサーバー間の通信を可能にする。
• モデル「ホスト」とサーバー間でのリソース、ツール、プロンプトなどのやり取りをサポートする。

📦 インストール

前提条件

• Go 1.18 以上

実行例

# MCPサーバーのURLを設定（オプション、デフォルトは http://localhost:3000/jsonrpc）
export MCP_SERVER_URL=http://your-mcp-server/jsonrpc

# 実行例を実行
go run examples/mcp_client_example.go

💻 使用例

基本的な使用法

import (
    "fmt"
    
    "path/to/mcp"
)

func main() {
    // 新しいクライアントを作成
    client := mcp.NewClient("http://your-mcp-server/jsonrpc")
    
    // クライアントを初期化
    clientInfo := mcp.Implementation{
        Name:    "My MCP Client",
        Version: "1.0.0",
    }
    
    capabilities := mcp.ClientCapabilities{
        // クライアントがサポートする機能を指定
    }
    
    err := client.Initialize(clientInfo, capabilities)
    if err != nil {
        // エラーを処理
    }
    
    // これで様々なクライアントメソッドを使用できます：
    
    // リソースを列挙
    resources, err := client.ListResources("")
    
    // リソースを読み取る
    resource, err := client.ReadResource("resource-uri")
    
    // ツールを呼び出す
    result, err := client.CallTool("tool-name", map[string]interface{}{
        "argument1": "value1",
        "argument2": 123,
    })
    
    // プロンプトを取得
    prompt, err := client.GetPrompt("prompt-name", map[string]string{
        "argName": "argValue",
    })
}

📚 ドキュメント

リポジトリの内容

• mcp/schema.go：TypeScriptのスキーマから変換されたMCPスキーマのGo構造体定義
• mcp/client.go：MCPサーバーと通信するクライアントの実装
• examples/mcp_client_example.go：クライアントの使い方を示す簡単な例

MCPの概要

モデルコンテキストプロトコル（MCP）は、モデル「ホスト」（LLMクライアントやLLMとインターフェースするシステムなど）とサーバー（コンテキスト情報、ツール、プロンプト、またはLLMの機能を強化するリソースを提供するシステム）間の通信を可能にします。

MCPの主要な機能は以下の通りです。

• リソース：ホストが読み取ることができるファイル、ドキュメント、その他のデータ
• ツール：ホストがモデルを代表して呼び出すことができる関数
• プロンプト：ホストが使用できるテンプレートまたは事前定義されたメッセージシーケンス
• ルートディレクトリ：サーバーが操作できるファイルシステムまたはデータのルート

実装の詳細

スキーマ

mcp/schema.go のGoスキーマ定義は、MCPメッセージの型安全な構造を提供します。これには以下が含まれます。

• JSON - RPCプロトコルの構造
• リソース、プロンプト、ツールの定義
• テキスト、画像、埋め込みリソースのコンテンツ構造
• json.RawMessage を使用した多態型の処理ヘルパー関数

クライアント

mcp/client.go のクライアント実装は、以下のメソッドを提供します。

• MCPサーバーとの接続を初期化する
• リクエストを送信し、レスポンスを処理する
• Go構造体をJSON - RPCメッセージに変換する
• 一般的なMCP操作のヘルパーメソッド

🤝 貢献

貢献を歓迎します！以下の方法で参加できます。

• サーバーを実装する
• 問題や機能要求を提出する
• コードの修正や新機能を提出する

詳細については、CONTRIBUTING.md を参照してください。

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。