使用说明（Markdown 格式）

• 项目简介
  • Reflex DevTools MCP 服务器是 Reflex DevTools 生态的一部分，提供一个 MCP 服务端，供 AI 客户端（如 Claude、Cursor 等）通过 MCP 协议读取应用追踪、状态、订阅以及执行工具等能力，以实现对 Reflex 应用的 AI 助手化调试和控制。
• 主要功能点
  • 提供与 Reflex DevTools 的集成接口，暴露以下工具供 AI 客户端调用：
    • get_traces：检索执行追踪数据，支持限流、事件过滤、最小时长、操作类型等筛选。
    • get_app_state：获取当前应用数据库/状态，支持指定路径取值。
    • get_active_subs：获取当前活跃订阅信息，支持按键名过滤。
    • get_handlers：列出注册的事件/效果/协同效果/订阅等处理器。
    • dispatch_event：将指定事件及参数派发给客户端应用，触发相应处理逻辑。
  • 与 Reflex DevTools 的 HTTP/REST API 进行交互，使用 DevToolsAPIClient 实现对追踪、状态等数据的获取。
  • 通过 stdio/WebSocket 传输实现 MCP 服务器与 AI 客户端的交互（支持工具查询与调用）。
• 安装步骤
  • 全局安装 MCP 服务端组件（示例命令，具体取决于环境及包管理工具）：
    • 使用 MCP 服务端包进行全局安装（示例：npm install -g @flexsurfer/reflex-devtools-mcp）
• 服务器配置
  • MCP 客户端（如 Claude Desktop、Cursor IDE）需要在配置中声明要连接的 MCP 服务器。下面给出一个示例配置（JSON 格式，供参考；实际客户端无需运行此配置，只需在客户端设定中指定服务器信息）： { "mcpServers": { "reflex-devtools": { "command": "npx", "args": ["reflex-devtools-mcp"], "env": {} } // 说明：以上配置用于 Claude Desktop / Cursor IDE 将 reflex-devtools-mcp 作为 MCP 服务器来接入 Reflex DevTools 的 MCP 服务端。 } }
• 运行与基本使用
  • 启动 MCP 服务端（通过 Reflex DevTools 主服务器开启并带上 MCP 支持，参见项目说明中的快速使用）。一旦 MCP 服务端启动并连接，将暴露一组可通过 MCP 客户端调用的工具。
  • 使用 MCP 客户端调用工具时，可以先查询工具列表（ListTools），再按名称执行相应的工具调用（CallTool），传入所需参数。
  • 常见操作包括读取应用状态、获取追踪数据、查看活跃订阅、分发事件等，用于 AI 助手与应用之间的交互与调试。