Golang MCP Server Sdk

🚀 Golang MCP サーバー SDK ドキュメント

Golang MCP サーバー SDK は、Model Context Protocol (MCP) 標準に準拠したサーバーを迅速に構築するための開発ツールキットです。この SDK は、豊富な機能モジュールと柔軟な設定オプションを提供し、開発者が MCP プロトコルの統合と拡張を簡単に実現できるように支援します。

✨ 主な機能

公共 API パッケージ（pkg/）

• builder/：ビルダーパターンを使用してサーバーインスタンスを作成します。
• server/：サーバーの核心実装ロジックが含まれています。
• tools/：MCP ツールを作成するために必要なユーティリティ関数を提供します。
• types/：共有される型とインターフェースを定義します。

私有実装詳細（internal/）

SDK の内部実装コードが含まれており、ユーザーが直接使用する必要はありません。

💻 使用例

基本的な使用法

SDK は複数のサンプルプロジェクトを提供しており、examples/ ディレクトリにあります。

シンプルなエコーサーバー

# サンプルを実行する
go run examples/echo_server.go

高度な計算機サーバー

# HTTP モードで実行する
go run examples/calculator/main.go --mode http

# 標準入出力モードで実行する
go run examples/calculator/main.go --mode stdio

高度な使用法

SDK は、さまざまな使用シナリオに応じて、複数のトランスポートプロトコルをサポートしています。

標準入出力（stdio）

コマンドラインツールや直接統合に適しています。

// stdio サーバーを起動する
if err := mcpServer.ServeStdio(); err != nil {
    fmt.Fprintf(os.Stderr, "エラー: %v\n", err)
    os.Exit(1)
}

HTTP プロトコル（SSE をサポート）

Web アプリケーションに適しており、リアルタイム通信機能を提供します。

// HTTP アドレスを設定する
mcpServer.SetAddress(":8080")

// HTTP サーバーを起動する
if err := mcpServer.ServeHTTP(); err != nil {
    log.Fatalf("HTTP サーバーエラー: %v", err)
}

// エレガントにシャットダウンする
ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
defer cancel()
if err := mcpServer.Shutdown(ctx); err != nil {
    log.Fatalf("サーバーシャットダウンエラー: %v", err)
}

多プロトコルサポート

複数のプロトコルのサーバーを同時に実行することができます。

// サーバーを構成して、HTTP と stdio の両方をサポートする
mcpServer := server.NewMCPServer("多プロトコルサーバー", "1.0.0")
mcpServer.SetAddress(":8080")
mcpServer.AddTool(ctx, echoTool, handleEcho)

// goroutine で HTTP サーバーを起動する
go func() {
    if err := mcpServer.ServeHTTP(); err != nil {
        log.Fatalf("HTTP サーバーエラー: %v", err)
    }
}()

// メインスレッドで stdio サーバーを起動する
if err := mcpServer.ServeStdio(); err != nil {
    log.Fatalf("Stdio サーバーエラー: %v", err)
}

📚 ドキュメント

テストとデバッグ

MCP Inspector を使用してテストを行います。

# エコーツールをテストする
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"echo","parameters":{"message":"Hello, World!"}}}' | go run your_server.go

貢献ガイド

貢献を歓迎します！自由に Pull Request を送信してください。

連絡先

開発者に連絡するには、[あなたのメールアドレス]にメールを送信してください。

📄 ライセンス

MIT License

Copyright (c) [年] [作者名]

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Golang MCP サーバー SDK をご利用いただき、ありがとうございます！