使用Go开发MCP Server, 太简单了!

快速掌握Go语言开发MCP Server，从入门到实践。

核心内容：

• Go生态中MCP库的选择与比较
• 使用mark3labs/mcp-go库快速搭建MCP服务
• 资源与工具的添加，实现数据暴露与LLM执行

好，不绕弯子，假设你对MCP（Model Context Protocol）的背景已经心里有数。目前Go生态里有两款比较知名的MCP开发库：一个是mark3labs/mcp-go^[1]，另一个是metoro-io/mcp-golang^[2]。两个用起来都很顺手，这次咱们按star数量选第一个来做演示。

mcp-go 入门

mark3labs/mcp-go这个库提供了丰富的示例代码，而且README里已经把每种MCP Tool类型的写法都列出来了，算是很贴心的入门指南。

启动服务

MCP支持SSE和标准输入输出两种通信方式。平时在自己机器上开发测试，标准输入输出（stdio）是最常见的用法：

// Create a basic server
s := server.NewMCPServer(
    "My Server",  // Server name
    "1.0.0",     // Version
)

// Start the server using stdio
if err := server.ServeStdio(s); err != nil {
    log.Fatalf("Server error: %v", err)
}

几行代码就能跑起一个MCP服务，没什么复杂的。

增加资源

资源是你向LLM暴露数据的方式。它们可以来自任何地方：文件、API响应、数据库查询、系统信息等等。资源分两种：

• 静态资源（固定URI）
• 动态资源（使用URI模板）

下面是一个静态资源的例子——暴露一个README文件：

// Static resource example - exposing a README file
resource := mcp.NewResource(
    "docs://readme",
    "Project README",
    mcp.WithResourceDescription("The project's README file"),
    mcp.WithMIMEType("text/markdown"),
)

// Add resource with its handler
s.AddResource(resource, func(ctx context.Context, request mcp.ReadResourceRequest) ([]mcp.ResourceContents, error) {
    content, err := os.ReadFile("README.md")
    if err != nil {
        return nil, err
    }

    return []mcp.ResourceContents{
        mcp.TextResourceContents{
            URI:      "docs://readme",
            MIMEType: "text/markdown",
            Text:     string(content),
        },
    }, nil
})

看到没？定义资源的时候指定一个URI和MIME类型，再写一个handler读取真实数据，一个数据暴露通道就打通了。

增加工具

工具让LLM通过你的服务器执行操作。和资源不同，工具预期会进行实际的运算并产生副作用——你可以把它想象成REST API里的POST端点。下面是一个简单的算术工具：

calculatorTool := mcp.NewTool("calculate",
    mcp.WithDescription("Perform basic arithmetic calculations"),
    mcp.WithString("operation",
        mcp.Required(),
        mcp.Description("The arithmetic operation to perform"),
        mcp.Enum("add", "subtract", "multiply", "divide"),
    ),
    mcp.WithNumber("x",
        mcp.Required(),
        mcp.Description("First number"),
    ),
    mcp.WithNumber("y",
        mcp.Required(),
        mcp.Description("Second number"),
    ),
)

s.AddTool(calculatorTool, func(ctx context.Context, request mcp.CallToolRequest) (*mcp.CallToolResult, error) {
    op := request.Params.Arguments["operation"].(string)
    x := request.Params.Arguments["x"].(float64)
    y := request.Params.Arguments["y"].(float64)

    var result float64
    switch op {
    case "add":
        result = x + y
    case "subtract":
        result = x - y
    case "multiply":
        result = x * y
    case "divide":
        if y == 0 {
            return nil, errors.New("Division by zero is not allowed")
        }
        result = x / y
    }

    return mcp.FormatNumberResult(result), nil
})

工具的用途远不止计算，它可以做很多事情：

• 数据库查询
• 文件操作
• 外部API调用
• 计算
• 系统操作

每个工具设计时都应该注意：

• 有清晰的描述
• 验证输入
• 优雅处理错误
• 返回结构化的响应
• 使用适当的结果类型

增加提示

提示（Prompt）是预定义的模板，LLM会按模板和用户进行交互。下面是一个问候提示的例子，它需要一个名字参数，然后返回一段问候语：

// Simple greeting prompt
s.AddPrompt(mcp.NewPrompt("greeting",
    mcp.WithPromptDescription("A friendly greeting prompt"),
    mcp.WithArgument("name",
        mcp.ArgumentDescription("Name of the person to greet"),
    ),
), func(ctx context.Context, request mcp.GetPromptRequest) (*mcp.GetPromptResult, error) {
    name := request.Params.Arguments["name"]
    if name == "" {
        name = "friend"
    }

    return mcp.NewGetPromptResult(
        "A friendly greeting",
        []mcp.PromptMessage{
            mcp.NewPromptMessage(
                mcp.RoleAssistant,
                mcp.NewTextContent(fmt.Sprintf("Hello, %s! How can I help you today?", name)),
            ),
        },
    ), nil
})

实战：实现一个查询IP地理信息的MCP Tool

理论知识够用了，来一个真正能用的东西——查询IP地址地理位置的MCP工具。

先写出main函数的主逻辑：

package main

import (
	"context"
	"errors"
	"fmt"
	"io"
	"net"
	"net/http"

	"github.com/kataras/golog"
	"github.com/mark3labs/mcp-go/mcp"
	"github.com/mark3labs/mcp-go/server"
)

func main() {
	// Create MCP server
	s := server.NewMCPServer(
		"ip-mcp",
		"1.0.0",
	)

	// Add tool
	tool := mcp.NewTool("ip_query",
		mcp.WithDescription("query geo location of an IP address"),
		mcp.WithString("ip",
			mcp.Required(),
			mcp.Description("IP address to query"),
		),
	)

	// Add tool handler
	s.AddTool(tool, ipQueryHandler)

	// Start the stdio server
	if err := server.ServeStdio(s); err != nil {
		fmt.Printf("Server error: %v\n", err)
	}
}

这里我们创建了一个名为ip_query的工具，描述很清楚：查询IP地址的地理位置。它需要一个参数：待查询的IP地址。具体逻辑交给ipQueryHandler函数去实现。通信方式选的是标准输入输出，本地测试最方便。

接下来是ipQueryHandler的实现。之前我搭过一个IP地址查询网站 https://ip.rpcx.io，直接调用它的API，封装起来非常简单。

请求到的数据（JSON格式）直接以文本方式返回给MCP Client。Client拿到的是JSON字符串，自己解析就好。

func ipQueryHandler(ctx context.Context, request mcp.CallToolRequest) (*mcp.CallToolResult, error) {
	ip, ok := request.Params.Arguments["ip"].(string)
	if !ok {
		return nil, errors.New("ip must be a string")
	}

	parsedIP := net.ParseIP(ip)
	if parsedIP == nil {
		golog.Errorf("invalid IP address: %s", ip)
		return nil, errors.New("invalid IP address")
	}

	resp, err := http.Get("https://ip.rpcx.io/api/ip?ip=" + ip)
	if err != nil {
		golog.Errorf("Error fetching IP information: %v", err)
		return nil, fmt.Errorf("Error fetching IP information: %v", err)
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		golog.Errorf("Error reading response body: %v", err)
		return nil, fmt.Errorf("Error reading response body: %v", err)
	}

	return mcp.NewToolResultText(string(data)), nil
}

注意参数合法性检查和错误处理这些常规操作。2025年了，这类琐事交给GitHub Copilot这类工具自动补全，一路回车就行。

编译成可执行二进制文件：

go build -o ip-mcp

你可以把它放在系统目录里方便调用，也可以不放在系统目录——后面配置MCP Server时需要指定它的路径。

测试MCP Server

测试工具我们选用deepchat^[3]，它已经原生支持MCP，配置起来极其简单。

在MCP配置界面，新增一个MCP Server，配置如下（注意把ip-mcp工具的路径换成你本地的实际路径）：

然后启动它：

此时在对话框窗口应该能看到运行着的MCP Tool列表，我们刚写的IP查询工具就在其中：

直接打一句“查询一下8.8.8.8的地理位置”试试——

测试正常。而且看起来deepchat还会把工具的返回结果自动交给deepseek进一步处理，体验很流畅。

就这样，一个简单的MCP Server实现了，并且跑通了全流程。可以看到，我们可以非常快速地把已有的API或产品封装成MCP工具——这也是百度地图、高德地图能迅速推出MCP Server的原因。