05 Make Your MCP Server

🚀 Goを使用したMCPサーバーの作成とDockerによるサービス提供

Go言語を使用してMCPサーバーを作成し、Dockerを通じてサービスを提供する方法について説明します。この方法により、LLMにより強力な機能を付与することができます。

🚀 クイックスタート

はじめに

今日は、Go言語を使用してMCPサーバーを作成し、Dockerを使用してデプロイする方法を探ります。

前提条件：『理解モデルコンテキストプロトコル（MCP）』を読んでいること。

MCPサーバーを作成するには、いくつかの公式SDKを使用できます。

• TypeScript SDK
• Python SDK

このチュートリアルでは、Goを使用して実装します。

✨ 主な機能

このプロジェクトでは、以下の主な機能を実現します。

• Go言語を使用してMCPサーバーを作成する。
• Dockerを使用してMCPサーバーをパッケージ化する。
• mcphost ツールを使用してMCPサーバーをテストする。

📦 インストール

MCPサーバーの作成

まず、基本的なMCPサーバー構造が必要です。以下は簡単な例です。

package main

import (
	"context"
	"fmt"
	"log"
	"net"
	"os"

	pb "github.com/protocolbuffers/protobuf/proto"
	emptypb "google.golang.org/protobuf/types/descriptorpb"
)

func main() {
	listener, err := net.Listen("tcp", ":8080")
	if err != nil {
		log.Fatal(err)
	}

	fmt.Printf("Server listening at %v\n", listener.Addr())

	for {
		conn, err := listener.Accept()
		if err != nil {
			log.Fatalf("Accept: %v", err)
		}
		defer conn.Close()

		go handleConnection(conn)
	}
}

func handleConnection(conn net.Conn) {
	ctx := context.Background()
	stream := pb.NewStream(conn)

	for {
		select {
		case <-ctx.Done():
			return
		default:
			frame, err := stream.ReadFrame()
			if err != nil {
				log.Printf("Read: %v", err)
				break
			}

			switch frame.(type) {
			case *pb.Frame_Data:
				dataFrame := frame.(*pb.Frame_Data)
				fmt.Printf("Received data: %s\n", dataFrame.GetData())
			case *emptypb.Frame_End:
				log.Println("Connection closed by client")
				return
			default:
				log.Printf("Unexpected frame type")
			}
		}
	}
}

この例では、Goの protobuf パッケージを使用して、データフレームを受信および処理できる簡単なTCPサーバーを作成する方法を示しています。

Dockerを使用したMCPサーバーのパッケージ化

MCPサーバーを本番環境にデプロイするには、Dockerを使用してパッケージ化できます。以下は対応するDockerfileです。

FROM golang:1.23.4-alpine AS builder
WORKDIR /app
COPY go.mod .
COPY main.go .

RUN <<EOF
go mod tidy 
go build
EOF

FROM curlimages/curl:8.6.0
WORKDIR /app
COPY --from=builder /app/mcp-curl .
ENTRYPOINT ["./mcp-curl"]

Dockerfileの説明：

1. golang:1.23.4-alpine をビルド用のベースイメージとして使用します。
2. 作業ディレクトリを /app に設定します。
3. go.mod と main.go を作業ディレクトリにコピーします。
4. go mod tidy を実行して依存関係を整理し、実行可能ファイルをコンパイルします。
5. curlimages/curl:8.6.0 を実行時のベースイメージとして使用し、ビルドされた実行可能ファイルを /app ディレクトリにコピーします。
6. デフォルトの起動コマンドを mcp-curl の実行に設定します。

Dockerイメージをビルドするには、以下のコマンドを実行します。

docker build -t mcp-curl .

💻 使用例

基本的な使用法

mcphost ツールを使用してMCPサーバーをテストするには、まず構成ファイル mcp.json を作成します。

{
  "mcpServers": {
    "mcp-curl-with-docker" :{
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp-curl"
      ]
    }
  }
}

次に、mcphost を起動し、構成ファイルとモデルを指定します。

mcphost --config ./mcp.json --model ollama:qwen2.5-coder:14b

以下は実行結果の例です。

1. MCPサーバーが認識されます。
2. 利用可能なツールのリストを要求します。
3. curl ツールを呼び出してWebページの内容を取得します。
4. 処理が完了するのを待ちます。
5. 返されたWebページの内容を表示します。

📚 ドキュメント

まとめ

以上の手順により、LLMにより強力な機能を簡単に付与することができます。後続の記事では、Goを使用してMCPクライアントを作成し、サーバーとのやり取り方法を紹介します。

この記事が、GoとDockerを使用して完全なMCPサーバーを実装する方法を理解するのに役立つことを願っています！