Beeper MCP Server

🚀 喇叭 MCP 服務器

喇叭 MCP 服務器是一個用於與區塊鏈交互的工具。它實現了簡單的筆記存儲系統，具備自定義 URI 方案訪問筆記、生成筆記摘要以及添加新筆記等功能，為區塊鏈相關操作提供便利。

✨ 主要特性

資源

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

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

提示

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

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

工具

服務器實現了一個工具：

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

📦 安裝指南

Claude Desktop

• MacOS：配置文件路徑為 ~/Library/Application\ 支持/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 檢查器。

您可以使用 npm 通過以下命令啟動 MCP 檢查器：

npx @modelcontextprotocol/inspector uv --directory /Users/pan/work/openos/beeper/beeper_mcp run beeper-mcp

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