MCP Server Sample

🚀 MCP 服務器示例

本項目是一個符合 Model Context Protocol (MCP) 標準的服務器基礎實現。MCP 協議用於在模型和本地運行的 MCP 服務器之間搭建通信橋樑，為模型交互提供了穩定可靠的通信機制。

🚀 快速開始

克隆倉庫

git clone <repository-url>
cd mcp-server-sample

安裝依賴

go mod tidy

運行服務器

go run main.go

✨ 主要特性

• 能夠處理通過標準輸入輸出的 JSON 消息，確保數據的高效傳輸和解析。
• 嚴格遵循 MCP 協議的基本數據類型定義，保證數據的準確性和一致性。
• 具備完善的錯誤處理功能，增強系統的穩定性和可靠性。

📦 安裝指南

1. 克隆倉庫：將項目倉庫克隆到本地。

git clone <repository-url>
cd mcp-server-sample

2. 安裝依賴：使用 go mod tidy 命令安裝項目所需的依賴。

go mod tidy

3. 運行服務器：通過 go run main.go 命令啟動服務器。

go run main.go

💻 使用示例

基礎用法

以下是 ServerInfo 結構體的定義，用於管理服務器的基本信息。

type ServerInfo struct {
    Name    string `json:"name"`
    Version string `json:"version"`
}

高級用法

以下是 Server 結構體的定義，提供了 MCP 服務器的基本功能。

type Server struct {
    info         ServerInfo
    capabilities map[string]interface{}
}

📚 詳細文檔

項目結構

.
├── main.go              # 主服務器實現文件
├── go.mod              # Go 模塊定義文件
└── server/
    └── types.go        # MCP 協議的類型定義

主要組件

ServerInfo (main.go)

管理服務器基本信息的結構體。

type ServerInfo struct {
    Name    string `json:"name"`
    Version string `json:"version"`
}

Server (main.go)

提供 MCP 服務器基本功能的結構體。

type Server struct {
    info         ServerInfo
    capabilities map[string]interface{}
}

MCP 消息類型 (server/types.go)

• Request: 表示客戶端發送的請求
• Response: 表示服務器返回的響應
• Error: 表示錯誤信息

擴展功能

此服務器可通過以下功能進行擴展：

1. 工具的實現
   • 添加特定功能的工具
   • 定義工具的參數和響應
2. 資源的實現
   • 添加靜態/動態資源
   • 定義資源模板
3. 消息處理程序
   • 實現特定方法的處理程序
   • 自定義錯誤處理

📄 許可證

此項目以 MIT 許可證發佈。