Claw Control MCP 服务端

使用说明内容（Markdown格式）

• 项目简介

  • 该仓库实现了一个基于 MCP 的后端服务器，用于管理资源（如任务、代理、消息等）并注册/执行工具，允许 AI 客户端通过 MCP 协议调用后端功能，提供一个可扩展的上下文服务框架。

• 主要功能点

  • MCP 工具注册与执行：定义若干工具（如 list_tasks、create_task、update_task、list_agents、update_agent_status、post_message），并实现对应处理逻辑。
  • 资源与数据访问：通过内置数据库适配层（SQLite/PostgreSQL）访问和修改任务、代理、消息等资源。
  • 通过 STDIO 传输的 MCP 服务端：使用 @modelcontextprotocol/sdk 的服务器实现，采用标准的 MCP 请求/响应模式，支持与 LLM/代理进行无缝对接。
  • 数据库与迁移支持：包含迁移脚本、种子数据脚本，支持在不同数据库类型上的模式创建与数据准备。
  • 实时事件与集成：通过内部广播和钩子实现任务/代理等事件的分发（对接外部系统/Webhook 的潜在扩展点）。

• 安装步骤

  • 1. 安装依赖
    • 在后端目录中执行安装，确保 Node.js 环境就绪。
  • 2. 启动 MCP 服务器
    • 使用 Node.js 启动 MCP 服务器脚本：packages/backend/src/mcp-server.js
  • 3. 连接方式
    • MCP 客户端应通过标准输入/输出（stdio）与服务器通信，按照 MCP 的工具查询和调用格式发送请求。
  • 4. 配置与调试
    • 如需数据库，请按项目的环境变量说明配置 DATABASE_URL 等参数；如使用 OpenAI/Claude 这类代理接入，请在客户端按需要进行环境变量/身份验证配置。

• 服务器配置（MCP 客户端使用的配置，格式为 JSON，包含 serverName、command、args 等） { "serverName": "claw-control", "command": "node", "args": ["packages/backend/src/mcp-server.js"] } 注释：

  • serverName: MCP 服务端的名称，用于标识与客户端的交互。
  • command: 启动服务器所使用的执行命令。
  • args: 启动命令的参数，包含 MCP 服务器脚本的位置。MCP 客户端无需额外的实现细节，仅需知道如何启动服务器。

• 基本使用方法

  • 1. 启动后端 MCP 服务端，确保标准输入/输出可与 MCP 客户端对接。
  • 2. 客户端启动后即可请求工具的列表、执行工具、读取与写入资源等操作。
  • 3. 客户端可通过工具调用与资源操作实现对 AI 代理的协作、任务管理与消息发布等场景。