关键词

Android应用聊天集成AI助手上下文Beeper消息发送

项目简介

Beeper 聊天数据 MCP 服务器是一个运行在Android设备上的后台服务，它将Beeper聊天应用中的聊天记录、联系人以及消息发送功能，通过标准的Model Context Protocol (MCP) 接口暴露给AI助手（如Claude Code）。这使得AI助手能够获取实时对话上下文并进行交互，极大地扩展了AI助手的应用场景。

主要功能点

  • 获取聊天记录: 允许AI助手检索Beeper中的所有聊天对话，并支持根据条件进行过滤。
  • 获取联系人信息: 允许AI助手访问Beeper中的联系人列表，并支持根据条件进行过滤。
  • 获取消息内容: 允许AI助手根据需求搜索和获取特定聊天中的消息内容。
  • 发送消息: 允许AI助手通过Beeper向指定的聊天发送消息，实现AI与用户的双向沟通。

安装步骤

  1. 环境准备:
    • 确保你的Android设备已安装Beeper应用。
    • Android系统版本需在8.0 (API level 26) 或更高。
    • 电脑上安装Android Studio 或相关的Gradle构建工具。
  2. 克隆仓库: 在电脑上打开终端或命令行工具，执行以下命令克隆项目代码： 
    git clone https://github.com/ahtavarasmus/TextAndDrive.git
cd TextAndDrive
  3. 连接Android设备:
    • 使用USB线将Android设备连接到电脑。
    • 在Android设备的“开发者选项”中启用“USB调试”（如果尚未开启）。
  4. 构建并安装应用:
    • 方法一 (命令行): 在项目根目录执行以下命令： 
      ./gradlew installDebug
    • 方法二 (Android Studio):
      1. 在Android Studio中打开克隆下来的项目。
      2. 等待Gradle文件同步完成。
      3. 点击“运行”按钮（通常是绿色的三角形图标），选择部署到你连接的Android设备。
  5. 应用内设置:
    • 安装完成后，在Android设备上打开“Beeper MCP Server”应用。
    • 根据提示，授予应用访问Beeper数据（读取/发送消息）的必要权限。
    • 为了确保服务稳定运行，强烈建议在系统设置中禁用该应用的电池优化功能，以防系统在后台杀死服务。
    • 授予权限并完成设置后，MCP服务器服务将自动启动。

服务器配置 (供MCP客户端连接使用)

MCP客户端需要配置与该服务器建立连接的信息。以下是一个示例JSON配置，它描述了MCP客户端如何连接到运行在Android设备上的Beeper MCP服务器。你需要将 '[DEVICE_IP]' 替换为你的Android设备的实际IP地址，该地址通常会在Beeper MCP Server应用界面中显示。

{
  "server_name": "beeper-android",
  "command": "claude mcp add",
  "args": [
    "--transport", "sse",
    "beeper-android",
    "http://[DEVICE_IP]:8081"
  ],
  "description": "连接到运行在Android设备上的Beeper MCP服务器。请将[DEVICE_IP]替换为你的Android设备的实际IP地址（可在服务器应用中查看），以便通过SSE协议访问Beeper聊天数据和功能。"
}

重要提示:

  • 这个JSON配置是提供给MCP客户端使用的，它定义了客户端如何连接到服务器。它不是服务器自身启动的命令。
  • 服务器本身是一个Android服务，在应用安装并授权后自动启动，并在 'http://[DEVICE_IP]:8081' 端口监听客户端连接。

基本使用方法

一旦Beeper MCP Server在你的Android设备上成功运行，并且你的MCP客户端（如Claude Code）已通过上述配置连接到它，AI助手就可以调用该服务器暴露的工具。例如：

  • AI助手可以使用 'get_chats' 工具来获取Beeper中的聊天列表。
  • AI助手可以使用 'send_message' 工具向指定的聊天发送消息。

注意事项:

  • 设备要求: Beeper MCP Server 必须安装在与 Beeper 聊天应用相同的 Android 设备上，才能访问其内容。
  • 网络连接: 确保你的 Android 设备和 MCP 客户端（如运行在电脑上的 Claude Code）处于同一局域网中，以便客户端能够通过 IP 地址访问服务器。
  • 权限管理: 务必授予 Beeper MCP Server 应用必要的 Beeper 访问权限，否则功能将无法正常使用。
  • 电池优化: 为了保证服务的持续运行和稳定性，建议禁用 Beeper MCP Server 应用的电池优化功能。

信息

分类

通信与社交

访问项目