🚀 Golang MCP 服务器 SDK 文档

Golang MCP 服务器 SDK 是一款强大的开发工具包，专为快速构建符合 Model Context Protocol (MCP) 标准的服务器而设计。它提供了丰富的功能模块和灵活的配置选项，能帮助开发者轻松实现 MCP 协议的集成与扩展，显著提升开发效率。

✨ 主要特性

公共 API 包（pkg/）

• builder/：借助构建器模式，可轻松创建服务器实例。
• server/：包含服务器的核心实现逻辑，保障服务器稳定运行。
• tools/：提供创建 MCP 工具所需的实用函数，方便开发者进行工具开发。
• types/：定义共享的类型和接口，确保代码的一致性和可维护性。

私有实现细节（internal/）

此部分包含 SDK 的内部实现代码，用户无需直接使用，减少了用户的使用复杂度。

📦 安装指南

文档未提及安装步骤，暂不提供相关内容。

💻 使用示例

基础用法

SDK 提供了多个示例项目，位于 examples/ 目录中。

简单回声服务器

# 运行示例
go run examples/echo_server.go

高级计算器服务器

# 以 HTTP 模式运行
go run examples/calculator/main.go --mode http

# 以标准输入输出模式运行
go run examples/calculator/main.go --mode stdio

高级用法

运行服务器

根据不同的使用场景，SDK 支持多种传输协议。

标准输入输出（stdio）

适用于命令行工具和直接集成：

// 启动一个 stdio 服务器
if err := mcpServer.ServeStdio(); err != nil {
    fmt.Fprintf(os.Stderr, "错误: %v\n", err)
    os.Exit(1)
}

HTTP 协议（支持 SSE）

适用于 Web 应用，提供实时通信功能：

// 配置 HTTP 地址
mcpServer.SetAddress(":8080")

// 启动一个 HTTP 服务器
if err := mcpServer.ServeHTTP(); err != nil {
    log.Fatalf("HTTP 服务器错误: %v", err)
}

// 优雅关闭
ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
defer cancel()
if err := mcpServer.Shutdown(ctx); err != nil {
    log.Fatalf("服务器关闭错误: %v", err)
}

多协议支持

可以同时运行多种协议服务器：

// 配置服务器以同时支持 HTTP 和 stdio
mcpServer := server.NewMCPServer("多协议服务器", "1.0.0")
mcpServer.SetAddress(":8080")
mcpServer.AddTool(ctx, echoTool, handleEcho)

// 启动 HTTP 服务器在 goroutine 中
go func() {
    if err := mcpServer.ServeHTTP(); err != nil {
        log.Fatalf("HTTP 服务器错误: %v", err)
    }
}()

// 启动 stdio 服务器在主线程中
if err := mcpServer.ServeStdio(); err != nil {
    log.Fatalf("Stdio 服务器错误: %v", err)
}

📚 详细文档

测试与调试

使用 MCP Inspector 进行测试：

# 测试回声工具
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"echo","parameters":{"message":"Hello, World!"}}}' | go run your_server.go

贡献指南

欢迎贡献！请随意提交 Pull Request，共同完善该 SDK。

联系方式

如需联系开发者，请发送邮件至：[你的邮箱地址]。

📄 许可证

MIT License

Copyright (c) [年份] [作者姓名]

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

感谢使用 Golang MCP 服务器 SDK！