基本能力
产品定位
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 工具进行调试。
使用教程
使用依赖
- Python:版本 3.10 或更高。
- Bee.computer API Key:从 Bee 开发者网站 获取 API 密钥。
安装教程
使用 uv(推荐)
bash
uvx beemcp
使用 PIP
bash
pip install beemcp
python -m beemcp.beemcp
调试方式
使用 uvx
bash
npx @modelcontextprotocol/inspector uvx beemcp
使用 pip
bash
npx @modelcontextprotocol/inspector python -m beemcp.beemcp