MCP Server On Raspi

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

本項目是一個運行在樹莓派上的MCP服務器，實現了簡單的筆記存儲系統，提供了資源訪問、提示生成和筆記添加等功能。

✨ 主要特性

資源

該服務器實現了一個簡單的筆記存儲系統，具備以下特性：

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

提示

服務器提供了一個提示功能：

• summarize-notes：能夠生成所有存儲筆記的摘要。
  • 支持可選的“風格”參數，可控制詳細程度（簡潔/詳細）。
  • 可根據風格偏好生成包含所有當前筆記的提示。

工具

服務器實現了一個工具：

• add-note：用於向服務器添加新的筆記。
  • 接受“名稱”和“內容”作為必需的字符串參數。
  • 會更新服務器狀態，並通知客戶端資源更改。

📦 安裝指南

安裝

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 服務器通過 stdio 運行，調試可能具有挑戰性。為了獲得最佳的調試體驗，我們強烈推薦使用 MCP Inspector。

您可以通過 npm 執行以下命令啟動 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 以開始調試。