内容：

你是否曾梦想着能够亲手搭建一个属于自己的MCP服务器？今天，就让我们一起走进这个神秘的世界，探索如何用十分钟的时间，从零开始，打造出一个功能强大的MCP服务器。

一、MCP服务器的基础架构

首先，我们来了解一下MCP服务器的基本架构。一个MCP服务器的核心是一个结构体，它包含了服务器的各种信息和能力。这个结构体就像是一个大脑，指挥着服务器的各项功能。

type MCPServer struct {
    name        string // 服务器名称
    version     string // 服务器版本
    initialized  atomic.Bool // 是否完成初始化
    capabilities ServerCapabilities // 服务器提供的能力
    tools       map[string]*ToolHandler // 工具注册表
    resources   map[string]*ResourceHandler // 资源模板注册表
    prompts     map[string]*PromptHandler // 提示处理器
    notifications map[string]*NotificationHandlerFunc // 通知处理器
}

在这个结构体中，我们可以看到服务器的名称、版本、初始化状态、支持的能力、工具注册表、资源模板注册表、提示处理器和通知处理器等关键信息。

二、MCP服务器的方法实现

接下来，我们要来实现MCP服务器提供的方法。其中，最核心的是HandleMessage方法，它是服务器处理客户端请求的总入口。

func (s *MCPServer) HandleMessage(message []byte) JSONRPCMessage {
    var baseMessage struct {
        JSONRPC string `json:"jsonrpc"`
        Method  string `json:"method"`
        ID      any    `json:"id,omitempty"`
    }

    // 根据method名字分发请求
    switch baseMessage.Method {
    case "initialize":
        return s.handleInitialize(baseMessage.ID)
    case "tools/list":
        return s.handleListTools(baseMessage.ID)
    case "tools/call":
        var request Request
        _ = json.Unmarshal(message, &request)
        return s.handleToolCall(baseMessage.ID, &request)
    default:
        return createErrorResponse(
            baseMessage.ID,
            METHOD_NOT_FOUND,
            fmt.Sprintf("Method %s not found", baseMessage.Method),
        )
    }
}

在这个方法中，我们根据请求的方法名，调用相应的处理函数。目前，我们实现了initialize、tools/list和tools/call三个基本功能。

三、MCP服务器的服务实例设计

有了MCP服务器的结构体和基本方法，我们就可以构建一个具体的实例，并向客户端开放相应的功能。

func NewMCPServer(name, version string) *MCPServer {
    tool := Tool{
        Name: "write_file",
        Description: "Create a new file or overwrite an existing file with new content.",
        InputSchema: ToolInputSchema{
            Type: "object",
            Properties: map[string]any{
                "path":    Property{Type: "string", Description: "Path where to write the file"},
                "content": Property{Type: "string", Description: "Content to write to the file"},
            },
            Required: []string{"path", "content"},
        },
    }

    toolHandler := &ToolHandler{
        Tool:    tool,
        Handler: handleWriteFile,
    }

    s := &MCPServer{
        name:    name,
        version: version,
        capabilities: ServerCapabilities{
            Tools: ToolCapabilities{ListChanged: true},
        },
        tools: map[string]*ToolHandler{"write_file": toolHandler},
    }

    return s
}

在这个实例中，我们注册了一个write_file工具，并提供了它的处理函数。这个函数将内容写入指定的文件中。

四、本地测试

最后，我们来测试一下我们的MCP服务器。首先，我们需要编译并运行服务器。

% go build -o mcp-fs-server main.go server.go
% ./mcp-fs-server

运行服务器后，我们可以看到服务器成功启动，并返回了一些基本的信息。接下来，我们向服务器发送一个initialize请求和一个tools/call请求，看看服务器是否能够正确处理这些请求。

{"jsonrpc":"2.0","id":1,"method":"initialize","params": {"protocolVersion":"2024-11-05","clientInfo": {"name":"example-client","version":"1.0.0"},"capabilities": {}}}

{"jsonrpc":"2.0","id":1,"result":{"protocolVersion":"2024-11-05","capabilities":{"tools":{"listChanged":true}},"serverInfo":{"name":"mcp-fs-server","version":"0.0.1"}}}

在/var/mcp-fs-server目录下，我们可以看到创建了一个test.txt文件，文件内容为：hello mcp。

五、在LLM应用程序中使用MCP服务器

现在，我们已经成功地搭建了一个MCP服务器，并且测试了它的基本功能。接下来，我们将展示如何在LLM应用程序中使用这个服务器。

以Claude Desktop为例，我们需要将其配置为使用我们的MCP服务器。在Claude Desktop的设置中，找到开发者选项，然后点击编辑配置文件。在配置文件中添加我们的MCP服务器的绝对路径和参数。

配置完成后，重新启动Claude Desktop，我们可以看到MCP服务器已经成功注册，并且可以在对话框的右下角看到MCP服务器的数量和详细信息。

接下来，我们向Claude Desktop发送一个写文件的指令，看看它是否能够成功执行。

通过以上步骤，我们已经成功地搭建了一个MCP服务器，并展示了如何在LLM应用程序中使用它。希望这篇文章能够帮助你更好地理解如何从零开始开发一个MCP服务器。