05 Make Your MCP Server

🚀 使用 Go 創建 MCP 服務器並通過 Docker 提供服務

本項目聚焦於使用 Go 語言創建 MCP 服務器，並藉助 Docker 進行部署，從而為 LLM 賦予更強大的功能，提升其應用能力與效率。

🚀 快速開始

先決條件

需提前閱讀《理解模型上下文協議（MCP）》。編寫 MCP 服務器時，有幾個官方 SDK 可供使用：

• TypeScript SDK
• Python SDK

本教程將使用 Go 語言來實現。

✨ 主要特性

• 運用 Go 語言的 protobuf 包創建 TCP 服務器，能夠高效接收和處理數據幀。
• 通過 Docker 進行打包部署，方便在生產環境中使用。

📦 安裝指南

構建 Docker 鏡像

要構建 Docker 鏡像，可運行以下命令：

docker build -t mcp-curl .

💻 使用示例

基礎用法

首先，我們需要一個基本的 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 服務器，能夠接收和處理數據幀。

高級用法

為了測試我們的 MCP 服務器，我們可以使用 mcphost 工具。

1. 創建配置文件

首先，創建一個配置文件 mcp.json：

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

2. 啟動 mcphost

然後，啟動 mcphost 並指定配置文件和模型：

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

3. 運行結果示例

以下是運行結果示例：

1. MCP 服務器被識別：

2. 請求可用工具列表：

3. 調用 curl 工具獲取網頁內容：

4. 等待處理完成：

5. 返回的網頁內容：

📚 詳細文檔

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"]

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。

🔚 結論

通過以上步驟，我們可以輕鬆賦予 LLM 更強大的功能。在後續的文章中，我們將展示如何使用 Go 創建一個 MCP 客戶端，並與我們的服務器進行交互。

希望這篇文章能幫助你理解如何使用 Go 和 Docker 實現一個完整的 MCP 服務器！