Go MCP Server Service

🚀 基於 Go 的 MCP 服務端（notes-server）

這是一個符合 JSON-RPC 2.0 標準的服務器，以示例形式實現了模型上下文協議 (MCP) 的筆記管理功能。您可以對其進行修改，並將其作為樣板代碼應用到自己的項目中。該服務端支持跨平臺開發，包含開發和發佈構建配置、命令行界面和服務組件。

✨ 主要特性

• 採用 JSON-RPC 2.0 標準接口
• 支持跨平臺（Windows、Linux、macOS）
• 具備線程安全的筆記管理功能
• 包含開發和發佈構建配置
• 擁有服務和命令行界面組件

📦 安裝指南

先決條件

• 需要安裝 Go 1.21 或更高版本
• 需使用 GNU Make 或兼容的構建工具
• 要安裝 Git（用於獲取版本信息）

構建命令

開發構建（包含調試符號和競態檢測）

# 構建所有組件的所有平臺
make dev

# 為特定平臺構建
make dev-windows
make dev-linux
make dev-darwin

# 構建特定組件
make build-cmd
make build-service

發佈構建（優化且去除符號）

# 構建所有組件的所有平臺
make release-all

# 為特定平臺構建
make release-windows
make release-linux
make release-darwin

本地運行

# 運行命令行界面
make run-cmd

# 運行服務
make run-service

查看所有目標選項

make help

構建輸出

二進制文件將創建在 bin 目錄中：

• 開發構建：bin/dev/
• 發佈構建：bin/release/

💻 使用示例

組件模塊

命令行界面 (cmd)

命令行界面可讓您直接訪問服務器功能。

服務 (service)

服務組件能夠實現系統級集成和後臺運行功能。

資源管理

服務器實現了一個筆記存儲系統，具體包括：

• 自定義 note:// URI 方案，用於訪問單個筆記
• 資源元數據（名稱、描述、MIME 類型）
• 線程安全的併發訪問

提示功能

可用提示命令：

• summarize-notes：創建所有存儲筆記的摘要
  • 可選參數：style（"簡潔"/"詳細"）
  • 根據風格偏好結合所有當前筆記
  • 線程安全的筆記訪問

工具功能

可用工具命令：

• add-note：向服務器添加新的筆記
  • 必要參數：name（字符串）、content（字符串）
  • 線程安全的狀態更新
  • 返回確認消息

配置指南

用於 Claude Desktop 的配置

要通過命令行界面配置，請執行以下命令：

# 設置 MCP 地址
export MCP_ADDR="http://localhost:8080"

# 設置 MCP 認證令牌
export MCP_TOKEN="your_token_here"

開發指南

項目結構

項目的文件夾結構如下所示：

notes-server/
├── cmd/
│   ├── main.go         # 命令行入口
│   └── service.go      # 服務實現
├── internal/
│   ├── handlers/       # 請求處理邏輯
│   └── models/         # 數據模型定義
└── go.mod              # 模塊依賴管理文件

調試與日誌

要啟用調試模式，請在運行時設置環境變量：

# 啟用調試模式
export DEBUG=true

默認情況下，服務會在標準錯誤流中輸出日誌。

📚 詳細文檔

錯誤碼定義

以下是 MCP 服務返回的錯誤代碼：

注意事項

⚠️ 重要提示

• 在生產環境中，請確保設置適當的防火牆和安全策略。
• 使用環境變量管理敏感信息，避免直接硬編碼。
• 定期備份數據以防止意外丟失。