Golang MCP Server Sdk

🚀 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！