Beemcp

🚀 BeeMCP 說明文檔

BeeMCP 是一個基於 Model Context Protocol (MCP) 的上下文管理器，專為增強 AI 助手的功能而設計。它支持通過 MCP 協議與各類 LLM（大語言模型）集成，實現對對話歷史、用戶事實、待辦事項和位置數據的高效管理和檢索。

🚀 快速開始

BeeMCP 提供了命令行工具，方便用戶快速開始使用：

啟動 BeeMCP 服務

bee-mcp start

訪問 BeeMCP 管理界面

啟動後，可以通過瀏覽器訪問 http://localhost:3001 進入管理界面。

✨ 主要特性

BeeMCP 提供了豐富的功能模塊，幫助用戶更好地管理和檢索數據：

對話歷史管理

• 列出所有對話：bee://conversations
• 獲取特定對話詳情：bee://conversations/{id}

用戶事實管理

• 記錄用戶事實：使用 record-user-fact 工具創建新事實。
• 更新現有事實：使用 update-user-fact 工具修改已有事實。
• 刪除指定事實：使用 delete-user-fact 工具移除不需要的事實。

待辦事項管理

• 列出所有待辦事項：bee://todos
• 獲取未完成的待辦事項：bee://todos/incomplete
• 獲取特定待辦事項詳情：bee://todos/{id}

位置數據管理

• 記錄當前位置：使用 record-location 工具自動或手動記錄地理位置。
• 查詢歷史位置：
  • 過去一天的位置：bee://locations/today
  • 過去一週的位置：bee://locations/week
  • 過去一個月的位置：bee://locations/month

高級特性

• 數據持久化：BeeMCP 支持將數據持久化到本地存儲，確保在服務重啟後數據不丟失。
• 擴展插件系統：用戶可以根據需求開發自定義插件，擴展 BeeMCP 的功能。插件可以通過 npm 或 pip 包管理器進行安裝和部署。

📦 安裝指南

BeeMCP 提供了多種安裝方式，以滿足不同開發環境的需求：

使用 uv 安裝

npm install bee-mcp -g

使用 pip 安裝（適用於 Python 環境）

pip install beemcp

💻 使用示例

示例交互

以下是一些使用 BeeMCP 的示例問題：

• "昨天的對話記錄有哪些？"
• "查找與 John 關於項目的對話內容。"
• "記住我喜歡喝黑咖啡。（-> record-user-fact）"
• "其實，我喜歡在咖啡里加牛奶。（-> update-user-fact）"
• "我的待辦事項有哪些？"
• "顯示未完成的任務列表。"
• "將‘購買雜貨’添加到提醒中。"
• "標記‘發送報告’任務為已完成。"
• "上週去了哪裡？"
• "今天訪問過哪些地方？"

🔧 技術細節

調試工具

為了方便開發者調試，BeeMCP 提供了 MCP 檢查器工具：

使用 uvx 運行

npx @modelcontextprotocol/inspector uvx beemcp

使用 pip 安裝

npx @model