BeeMCP - A Bee MCP Server

基本能力

产品定位

BeeMCP 是一个非官方的 Model Context Protocol (MCP) 服务器，用于与 Bee 可穿戴设备的生活日志数据进行交互。它充当桥梁，允许大型语言模型（如 Claude）或自定义 AI 代理访问和操作用户存储在 Bee 中的个人数据。

核心功能

• 对话管理：列出所有对话、获取特定对话详情。
• 事实管理：列出所有事实、获取特定事实详情、记录新事实、更新事实、确认事实、删除事实。
• 待办事项管理：列出所有待办事项、列出未完成的待办事项、创建新待办事项、更新待办事项、删除待办事项、标记待办事项为已完成。
• 位置管理：列出所有位置、获取今天的位置、获取本周的位置、获取本月的位置、获取特定时间范围内的位置。

适用场景

• 个人助理：帮助用户回顾过去的对话、管理待办事项、记录和查询个人事实。
• 位置追踪：查询用户过去的位置历史，帮助用户回忆去过的地方。
• AI 集成：为 AI 提供上下文数据，使其能够更智能地回答用户问题。

工具列表

• Conversations：list-all-conversations, get-conversation
• Facts：list-all-user-facts, get-user-fact, record-user-fact, update-user-fact, confirm-user-fact, delete-user-fact
• Todos (Reminders)：list-all-todos, list-incomplete-todos, create-todo, update-todo, delete-todo, mark-todo-completed
• Locations：list-all-locations, get-locations-today, get-locations-week, get-locations-month, get-locations-by-time

常见问题解答

• 如何获取 API Key：从 Bee 开发者网站获取 API 密钥。
• 如何配置环境变量：通过 .env 文件或直接设置环境变量 BEE_API_TOKEN。
• 如何调试：使用 MCP inspector 工具进行调试。

使用教程

使用依赖

1. Python：版本 3.10 或更高。
2. Bee.computer API Key：从 Bee 开发者网站 获取 API 密钥。

安装教程

使用 uv（推荐）

uvx beemcp

使用 PIP

pip install beemcp
python -m beemcp.beemcp

调试方式

使用 uvx

npx @modelcontextprotocol/inspector uvx beemcp

使用 pip

npx @modelcontextprotocol/inspector python -m beemcp.beemcp

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。