Mcpcalculator

🚀 MCP 計算器

MCP 計算器是一個用 Go 語言實現的模型上下文協議（MCP）服務器，具備計算器和問候功能，且嚴格遵循官方 MCP 規範。該項目為相關開發和應用提供了可靠的基礎。

✨ 主要特性

• 完整實現 JSON-RPC 2.0 協議，保障通信的標準化和規範性。
• 全面支持 MCP 協議，確保與其他遵循該協議的系統無縫對接。
• 支持工具註冊和執行，方便用戶靈活使用各種功能。
• 具備資源處理能力，有效管理和操作相關資源。
• 可進行服務器功能協商，根據實際需求調整服務能力。
• 依據規範進行錯誤處理，提高系統的穩定性和可維護性。

📦 安裝指南

環境要求

• Go 1.21 或更高版本

安裝步驟

git clone https://github.com/akhidasTech/mcpcalculator.git
cd mcpcalculator
go mod download

💻 使用示例

基礎用法

啟動服務器

go run main.go

服務器將在 8080 端口啟動。

發送請求

工具和資源遵循 JSON-RPC 2.0 規範：

添加工具

curl -X POST http://localhost:8080 \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "add",
    "params": {"a": 5, "b": 3}
  }'

問候資源

curl -X POST http://localhost:8080 \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "greeting",
    "params": {"name": "John"}
  }'

響應格式

所有響應都遵循 JSON-RPC 2.0 格式：

正常響應

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": <結果值>
}

錯誤響應

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": <錯誤代碼>,
        "message": "錯誤信息",
        "data": <額外數據>
    }
}

📚 詳細文檔

項目結構

mcpcalculator/
├── mcp/
│   └── protocol/
│       ├── types.go    # 協議類型和結構
│       ├── server.go   # MCP 服務器實現
│       └── client.go   # MCP 客戶端實現
├── main.go            # 示例用法
├── go.mod             # Go 模塊文件
└── README.md          # 文檔

協議實現

此實現遵循模型上下文協議規範：

1. JSON-RPC 2.0：所有通信都使用 JSON-RPC 2.0 協議，確保數據交互的標準化。
2. 功能：服務器在初始化時宣佈其能力，方便客戶端了解和使用。
3. 工具：實現了工具註冊和執行協議，支持用戶靈活調用各種工具。
4. 資源：實現了資源訪問協議，有效管理和操作相關資源。
5. 錯誤處理：使用標準錯誤代碼和格式，提高系統的可維護性。

安全性

此實現遵循 MCP 安全指南：

1. 用戶同意：工具和資源需要明確調用，保障用戶的自主選擇權。
2. 數據隱私：沒有未經明確請求的數據共享，保護用戶數據安全。
3. 工具安全：工具執行受到控制和驗證，防止惡意操作。
4. 錯誤處理：正確的錯誤報告和處理，及時發現和解決問題。

🤝 貢獻

歡迎貢獻！請隨意提交 Pull Request。