使用说明

项目简介

BeeMCP 是一个非官方的 Model Context Protocol (MCP) 服务器，旨在将 Bee 可穿戴设备 的生活记录数据接入大型语言模型 (LLM)。通过 BeeMCP，LLM 可以访问和操作您的 Bee 数据，例如对话记录、个人知识、待办事项和位置历史，从而为 LLM 应用提供更丰富的个人化上下文信息。

主要功能点

• 数据桥梁：连接 Bee 可穿戴设备和 LLM，使 LLM 能够访问您的个人生活数据。
• 资源管理：以 MCP 资源的形式暴露 Bee 数据，包括对话、知识库、待办事项和位置信息。
• 工具集成：提供一系列工具，允许 LLM 查询和操作 Bee 数据，例如：
  • 查询对话历史、个人知识、待办事项。
  • 创建、更新、删除个人知识和待办事项。
  • 查询位置记录。
• LLM 助手增强：使 LLM 能够理解和利用您的个人上下文，提供更智能、更个性化的服务。

安装步骤

1. 安装 Python：确保您的系统已安装 Python 3.10 或更高版本。
2. 获取 Bee API 密钥：访问 Bee 开发者网站 获取您的 API 密钥。
3. 安装 BeeMCP：
   • 推荐使用 uv (更快速): 如果已安装 'uv'，无需单独安装 BeeMCP，可以直接运行：

     uvx beemcp
     

   • 使用 pip 安装: 您可以使用 pip 安装 BeeMCP：

     pip install beemcp
     

服务器配置

MCP 服务器需要配置 Bee API 密钥才能访问您的 Bee 数据。您可以通过以下两种方式配置 API 密钥：

• 环境变量 (.env 文件)：在运行 BeeMCP 服务器的目录下创建 '.env' 文件，并添加以下内容，将 'your_actual_bee_api_key_here' 替换为您的实际 API 密钥：

  BEE_API_TOKEN="your_actual_bee_api_key_here"
  

• 系统环境变量：将 'BEE_API_TOKEN' 设置为系统环境变量。

MCP 客户端配置

您需要在 MCP 客户端（如 Claude 或 Zed）中配置 BeeMCP 服务器的启动命令，以便客户端可以连接到服务器。以下是针对 Claude 和 Zed 的配置示例（JSON 格式）：

Claude 配置示例 (settings.json):

"mcpServers": {
  "beemcp": { // 服务器名称，可以自定义
    "command": "uvx", // 启动命令，如果使用 pip 安装，则为 "python"
    "args": ["beemcp"], // 命令参数，如果使用 pip 安装，则为 ["-m", "beemcp.beemcp"]
    "env": {"BEE_API_TOKEN": "<YOUR API KEY HERE>"} // 环境变量，请替换为您的 Bee API 密钥
  }
}

Zed 配置示例 (settings.json):

"context_servers": [
  {
    "name": "beemcp", // 服务器名称，可以自定义
    "command": "uvx", // 启动命令，如果使用 pip 安装，则为 "python"
    "args": ["beemcp"], // 命令参数，如果使用 pip 安装，则为 ["-m", "beemcp.beemcp"]
    "env": {"BEE_API_TOKEN": "<YOUR API KEY HERE>"} // 环境变量，请替换为您的 Bee API 密钥
  }
],

基本使用方法

1. 启动 BeeMCP 服务器 (例如，运行 'uvx beemcp' 或 'python -m beemcp.beemcp')。
2. 在 MCP 客户端（Claude 或 Zed）中配置并连接到 BeeMCP 服务器。
3. 在 LLM 中提出与您的 Bee 数据相关的问题，例如：
   • "我昨天和谁谈论了什么？"
   • "提醒我买牛奶。"
   • "我上周去过哪里？" LLM 将通过 BeeMCP 服务器访问您的 Bee 数据并给出相应的回答或执行操作。