Model Context Protocol (mcp) Implementation In Go

🚀 模型上下文協議（MCP）在 Go 語言中的實現

本項目提供了一個基於 JSON - RPC 協議的 Go 語言實現，用於大語言模型 (LLM) 應用中客戶端與服務端之間的交互。該協議名為 Model Context Protocol (MCP)，其目標是增強大語言模型的功能。

🚀 快速開始

前提條件

• Go 1.18 或更高版本

運行示例

# 設置 MCP 服務器 URL（可選，默認為 http://localhost:3000/jsonrpc）
export MCP_SERVER_URL=http://your-mcp-server/jsonrpc

# 運行示例
go run examples/mcp_client_example.go

✨ 主要特性

模型上下文協議 (MCP) 實現了模型“宿主”（如 LLM 客戶端或與 LLM 接口的系統）和服務端（提供上下文信息、工具、提示語或增強 LLM 功能的資源的系統）之間的通信。其關鍵功能如下：

• 資源：文件、文檔和其他數據，宿主可以讀取。
• 工具：函數，宿主可以代表模型調用。
• 提示語：模板或預定義消息序列，宿主可以使用。
• 根目錄：服務端可以操作的文件系統或數據根。

📦 安裝指南

本項目運行需 Go 1.18 或更高版本，克隆倉庫後，按上述“運行示例”步驟操作即可。

💻 使用示例

基礎用法

import (
    "fmt"
    
    "path/to/mcp"
)

func main() {
    // 創建一個新的客戶端
    client := mcp.NewClient("http://your-mcp-server/jsonrpc")
    
    // 初始化客戶端
    clientInfo := mcp.Implementation{
        Name:    "My MCP Client",
        Version: "1.0.0",
    }
    
    capabilities := mcp.ClientCapabilities{
        // 指定你客戶端支持的功能
    }
    
    err := client.Initialize(clientInfo, capabilities)
    if err != nil {
        // 處理錯誤
    }
    
    // 現在你可以使用各種客戶端方法：
    
    // 列舉資源
    resources, err := client.ListResources("")
    
    // 讀取一個資源
    resource, err := client.ReadResource("resource-uri")
    
    // 調用工具
    result, err := client.CallTool("tool-name", map[string]interface{}{
        "argument1": "value1",
        "argument2": 123,
    })
    
    // 獲取提示語
    prompt, err := client.GetPrompt("prompt-name", map[string]string{
        "argName": "argValue",
    })
}

🔧 技術細節

模式

mcp/schema.go 中的 Go 模式定義為 MCP 消息提供了類型安全的結構，具體包括：

• JSON - RPC 協議結構。
• 資源、提示語和工具定義。
• 文本、圖像和嵌入資源的內容結構。
• 通過 json.RawMessage 處理多態類型的輔助函數。

客戶端

mcp/client.go 中的客戶端實現提供了以下方法：

• 初始化與 MCP 服務器的連接。
• 發送請求並處理響應。
• 將 Go 結構體轉換為 JSON - RPC 消息。
• 用於常見 MCP 操作的幫助器方法。

🤝 貢獻

歡迎大家參與貢獻！你可以通過以下方式參與：

• 實現一個服務端。
• 提交問題或功能請求。
• 提交代碼修復或新功能。

請查看 CONTRIBUTING.md 瞭解詳細信息。

📄 許可證

此項目受 MIT License 保護。