MCP Golang

🚀 使用 Go 語言實現的 MCP 服務器客戶端和服務器端功能詳解

本項目使用 Go 語言實現了 MCP 服務器的客戶端和服務器端功能，重點在於實現客戶端與服務端的雙向通信，具備工具調用、提示調用和資源管理等特性。

🚀 快速開始

本項目實現了客戶端與服務端的雙向通信，下面將詳細介紹其核心功能模塊。

✨ 主要特性

工具調用

• 支持工具調用，用戶可通過定義的工具接口進行功能擴展。
• 使用原生 Go 結構體作為參數，保障數據傳遞的安全性和類型安全。
• 提供程序化生成工具列表端點，方便客戶端動態獲取可用工具信息。
• 實現更改通知機制，讓客戶端及時獲知服務端工具的更新情況。
• 支持分頁功能，適用於工具數量較多時的高效數據管理。

提示調用

• 支持提示調用，用戶能通過預設的提示模板與服務端進行交互。
• 同樣使用 Go 結構體作為參數，確保數據的一致性和安全性。
• 自動生成提示列表端點，客戶端可動態獲取可用提示信息。
• 實現更改通知機制，保持客戶端與服務端信息同步。
• 支持分頁功能，適用於大量提示模板的管理場景。

資源管理

• 支持資源的增刪改查操作，方便用戶管理各類配置和數據。
• 自動生成資源列表端點，客戶端能夠即時獲取最新資源信息。
• 實現更改通知機制，確保客戶端與服務端數據同步。
• 支持分頁功能，適用於大量資源的高效管理。

💻 使用示例

基礎用法

工具調用

package main

import (
    "context"
    "log"
    mcp "github.com/metoro-io/mcp-golang"
    "github.com/metoro-io/mcp-golang/transport/stdio"
)

// 定義工具調用的參數結構體
type CalculateArgs struct {
    Operation string `json:"operation"`
    A         int    `json:"a"`
    B         int    `json:"b"`
}

func main() {
    // 創建並初始化客戶端
    transport := stdio.NewStdioServerTransport()
    client := mcp.NewClient(transport)

    if _, err := client.Initialize(context.Background()); err != nil {
        log.Fatalf("Failed to initialize: %v", err)
    }

    // 調用工具示例
    args := CalculateArgs{
        Operation: "add",
        A:         10,
        B:         5,
    }
    
    response, err := client.CallTool(context.Background(), "calculate", args)
    if err != nil {
        log.Fatalf("Failed to call tool: %v", err)
    }

    if response != nil && len(response.Content) > 0 {
        log.Printf("Result: %s", response.Content[0].TextContent.Text)
    }
}

提示調用

package main

import (
    "context"
    "log"
    mcp "github.com/metoro-io/mcp-golang"
    "github.com/metoro-io/mcp-golang/transport/stdio"
)

// 定義提示調用的參數結構體
type QueryArgs struct {
    Keywords    []string `json:"keywords"`
    PageSize   int      `json:"page_size"`
    PageNumber int      `json:"page_number"`
}

func main() {
    transport := stdio.NewStdioServerTransport()
    client := mcp.NewClient(transport)

    if _, err := client.Initialize(context.Background()); err != nil {
        log.Fatalf("Failed to initialize: %v", err)
    }

    // 調用提示示例
    args := QueryArgs{
        Keywords:    []string{"大數據", "分析"},
        PageSize:   10,
        PageNumber: 1,
    }
    
    response, err := client.CallPrompt(context.Background(), "data_analysis", args)
    if err != nil {
        log.Fatalf("Failed to call prompt: %v", err)
    }

    if response != nil && len(response.Content) > 0 {
        log.Printf("Result: %s", response.Content[0].TextContent.Text)
    }
}

資源管理

package main

import (
    "context"
    "log"
    mcp "github.com/metoro-io/mcp-golang"
    "github.com/metoro-io/mcp-golang/transport/stdio"
)
// 此處代碼示例原文檔未完整給出，可根據實際情況補充完整