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