Daikw MCP Server On Raspi

🚀 在樹莓派上運行的 MCP 服務器

本項目是一個 MCP 服務器，可在樹莓派上運行，實現了簡單的筆記存儲系統。

✨ 主要特性

資源

本服務器實現了一個簡單的筆記存儲系統，具備以下功能：

• 採用自定義的 note:// URI 方案，可用於訪問單個筆記。
• 每個筆記資源都有名稱、描述，且 MIME 類型為 text/plain。

提示

服務器提供瞭如下提示功能：

• summarize-notes：可生成所有存儲筆記的摘要。
  • 支持使用可選的 "style" 參數來控制詳細程度，有簡潔和詳細兩種風格可選。
  • 能根據風格偏好生成包含所有當前筆記的提示。

工具

服務器實現了一個實用工具：

• add-note：用於向服務器添加新的筆記。
  • 該工具接受 "name" 和 "content" 作為必需的字符串參數。
  • 會更新服務器狀態，並通知客戶端資源發生更改。

📦 安裝指南

Claude Desktop

• MacOS：配置文件路徑為 ~/Library/Application\ Support/Claude/claude_desktop_config.json。
• Windows：配置文件路徑為 %APPDATA%/Claude/claude_desktop_config.json%。

🚀 快速開始

構建和發佈

若要準備分發包，可按以下步驟操作：

1. 同步依賴項並更新鎖定文件：

uv sync

2. 構建軟件包分發：

uv build

執行上述命令後，會在 dist/ 目錄中創建源代碼和輪格式分發。 3. 發佈到 PyPI：

uv publish

注意：您需要通過環境變量或命令行參數設置 PyPI 憑據：

• 令牌：使用 --token 或 UV_PUBLISH_TOKEN。
• 或用戶名/密碼：使用 --username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD。

調試

由於 MCP 服務器通過標準輸入輸出運行，調試可能存在一定難度。為獲得最佳的調試體驗，強烈推薦使用 MCP Inspector。

您可以使用以下命令啟動 MCP Inspector：

npx @modelcontextprotocol/inspector uv --directory /Users/daikiwatanabe/ghq/github.com/daikw/mcp-server-on-raspi run mcp-server-on-raspi

啟動後，Inspector 會顯示一個 URL，您可以在瀏覽器中訪問該 URL 開始調試。