Go MCP

🚀 Go語言MCP協議庫

這是一個用於實現模型上下文協議（Model Context Protocol，簡稱MCP）的Go語言庫。該協議定義了AI模型與外界交互的標準接口，支持文本、圖像、音頻等多種內容類型的操作，為AI模型的交互提供了統一、高效的解決方案。

🚀 快速開始

安裝

go get github.com/your-organization/mcp-go

創建服務端

// 創建服務
server, err := mcp.NewServer(service, &types.ServerOptions{
    Address: ":8080",
    Capabilities: &types.ServerCapabilities{
        Prompts: &types.PromptCapabilities{
            ListChanged: true,
        },
        Resources: &types.ResourceCapabilities{
            ListChanged: true,
            Subscribe: true,
            Templates: true,
        },
    },
})

創建客戶端

// 創建客戶端
client, err := mcp.NewClient(&types.ClientOptions{
    ServerAddress: "localhost:8080",
    Type: "http",
    UseJSONRPC: true,
    SubscribeToNotifications: true,
})

✨ 主要特性

為什麼選擇MCP？

• 統一標準：基於最新的2025-03-26 MCP規範開發
• 功能豐富：支持提示詞、工具調用、資源操作等核心功能
• 擴展性強：內置了對多種媒體類型和資源格式的支持
• 高效可靠：採用異步非阻塞架構，性能優化明顯

協議更新 - 新增特性

• 完整的JSON RPC支持
• 多模態內容傳輸能力
• 分頁查詢功能
• 資源模板系統
• 資源訂閱通知
• 詳細的服務器聲明式能力
• 統一響應處理機制

📦 安裝指南

go get github.com/your-organization/mcp-go

💻 使用示例

基礎用法

// 提示詞操作
prompt := &Prompt{
    Content: "幫我寫一首詩",
    Parameters: map[string]string{
        "temperature": "0.7",
    },
}

response, err := client.SendPrompt(prompt)
if err != nil {
    // 處理錯誤
}

// 工具調用
toolResult, err := client.CallTool("image_generator", map[string]string{
    "prompt": "一片孤帆遠影碧空盡",
})
if err != nil {
    // 處理錯誤
}

📚 詳細文檔

接口定義

服務端接口

服務需要實現types.Server接口：

type Server interface {
    MCPService
    Initialize(ctx context.Context, options any) error
    Start() error
    Shutdown(ctx context.Context) error
}

核心功能由MCPService接口定義：

type MCPService interface {
    // 列出所有提示詞，支持分頁查詢
    ListPrompts(ctx context.Context, cursor string) (*PromptListResult, error)
    
    // 獲取特定提示詞內容，可指定參數
    GetPrompt(ctx context.Context, name string, args map[string]any) (*PromptResult, error)

    // 列出所有工具，支持分頁查詢
    ListTools(ctx context.Context, cursor string) (*ToolListResult, error)

    // 調用特定工具，可指定參數
    CallTool(ctx context.Context, name string, args map[string]any) (*CallToolResult, error)

    // 列出所有資源，支持分頁查詢
    ListResources(ctx context.Context, cursor string) (*ResourceListResult, error)

    // 讀取特定資源內容
    ReadResource(ctx context.Context, uri string) (*ResourceContent, error)

    // 獲取資源模板列表
    ListResourceTemplates(ctx context.Context) ([]ResourceTemplate, error)

    // 訂閱特定資源的變更通知
    SubscribeResource(ctx context.Context, resourceID string, callback func(*ResourceUpdateEvent)) error)
}

客戶端接口

type MCPClient interface {
    // 發送提示詞請求
    SendPrompt(prompt *Prompt) (*Response, error)

    // 調用工具方法
    CallTool(toolName string, args map[string]any) (*Response, error)

    // 訂閱資源更新通知
    SubscribeResource(resourceID string, callback func(*ResourceUpdateEvent)) error)
}

錯誤處理

type MCPError struct {
    Code    int    `json:"code"`
    Message string `json:"message"`
}

func (e *MCPError) Error() string {
    return e.Message
}

🔧 技術細節

貢獻指南

• 代碼規範：遵循Google Go語言風格指南
• 單元測試覆蓋率要求達到100%
• 提交PR前必須通過CI檢查
• 遵守GitHub的貢獻協議

📄 許可證

本項目使用MIT許可證，歡迎自由使用和修改。

更多詳細文檔請參考官方文檔。