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 服务器！