Andrewdonelson Go MCP Server Service

🚀 基於Go的MCP服務器服務

這是一個符合JSON-RPC 2.0協議的服務器實現，專門用於模型上下文協議（MCP）的筆記管理（以示例形式呈現）。此項目可作為樣板代碼，您可以根據需求修改代碼並應用到自己的項目中。它支持跨平臺開發，並且包含適用於開發和發佈構建的命令行界面與服務組件。

✨ 主要特性

• 符合標準的API：提供符合JSON-RPC 2.0協議的API。
• 跨平臺支持：支持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/
• 發佈構建：dist/

📚 詳細文檔

組件

命令行界面 (cmd)

命令行界面提供對筆記服務器功能的直接訪問。

服務 (service)

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

資源

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

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

提示

可用提示：

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

工具

可用工具：

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

項目結構圖

.
├── README.md               # 項目說明文檔
├── go.mod                 # Go模塊文件
├── go.sum                 # Go依賴項檢查和認證文件
├── cmd/
│   ├── add-note/
│   │   └── main.go       # 添加筆記的主程序
├── service/
│   └── server.go         # 服務端實現
└── resources/
    └── note_manager.go   # 筆記管理器

配置

在以下位置查找配置文件：

$XDG_CONFIG_HOME/mcnotes.json

默認情況下，這相當於：

~/.config/mcnotes.json

配置示例

{
  "debug": false,
  "port": 8080,
  "database": {
    "driver": "sqlite3",
    "path": "notes.db"
  }
}

錯誤代碼

📄 許可證

此項目在MIT License下開源。

⚠️ 重要提示

如有其他問題，請參考官方文檔。