Hello-Claw 发行版 MCP 服务器框架

关键词

对话代理自动化工具会话记忆安全沙箱Slack 集成

使用说明（Markdown 格式）

项目简介

  • Hello-Claw 是一个基于 Claude Agent SDK 的 MCP（Model Context Protocol）后端框架，集合了多种 MCP 服务器（如 Slack、Cron、Media、Search、Brain、Github、Oracle、Voice、Audio、Firecrawl、Browser 等），提供统一的能力暴露、会话管理和工作区记忆，目标是为大语言模型客户端提供结构化的上下文及功能入口。

主要功能点

  • 多 MCP 服务集合：在同一个宿主进程中暴露多类 MCP 服务（Slack、Cron、Media、Search、Brain、Github、Oracle、Voice、Audio、Firecrawl、Browser），实现资源管理、工具调用、以及提示模板的渲染与执行。
  • 安全与审计：通过沙箱、工具策略、域名白名单、密钥脱敏、CLAUDE.md 完整性校验、JSONL 审计日志等多层安全与审计机制。
  • 会话与记忆：基于工作区提供持续的身份记忆（SOUL.md、MEMORY.md 等），并对会话进行唯一标识、每日重置等管理。
  • 任务与工作流：Cron 与 GitHub 等工具支持人类确认的二阶段执行（emoji 表情触发批准）、以及基于 Slack 的审批流。
  • 动态系统提示与插件化：系统提示由工作区的 SOUL/MEMORY 等内容动态拼接，支持通过插件加载额外能力与工具。
  • 跨工具成本控制与监控：按日与会话维度记录成本、警报与预算控制，确保对外部 API 的使用可控。

安装步骤

  • 依赖获取
    • 克隆仓库
    • 安装依赖：npm install
  • 配置环境
    • 从 .env.example 复制为 .env，填入Anthropic、Slack、Gemini、Perplexity、GitHub、OpenAI、ElevenLabs、Firecrawl 等所需的 API Key 与配置
    • 配置 Slack 应用与 Socket Mode（App Token、Bot Token 等）并确保具备所需权限
  • 运行选项
    • 开发开发：npm run dev
    • 构建生产：npm run build，然后 npm start
  • 运行后
    • 控制台输出会显示进程信息，例如“[host] Starting hello-claw...”以及“hello-claw is running.”
    • 在 Slack 指定的频道中发送消息即可与 MCP 服务交互，系统会通过 MCP 服务器处理并返回结果

服务器配置（MCP 客户端的配置示例说明） 以下为 MCP 客户端需要了解的配置要点（JSON 结构，非代码块展示，便于理解）： { "server_name": "hello-claw", // MCP 服务器集合的名称标识 "command": "node", // 启动 MCP 服务器的执行程序 "args": ["dist/host.js"], // 启动参数，指向打包后的入口文件（Production 场景通常是 dist/host.js） "description": "Hello-Claw MCP 服务集合的宿主进程，启动后会暴露 Slack、Cron、Media、Search、Brain、Github、Oracle、Voice、Audio、Firecrawl、Browser 等 MCP 服务。" } 注：以上配置用于 MCP 客户端在客户端环境中定位并启动服务器。仓库在 README/代码中提供了多种运行方式（开发、构建生产），具体路径可能依据打包方式而定。该配置示例聚焦于准确表达服务器名称、启动命令与入口参数的含义。MCP 客户端本身在运行时不需要额外的程序逻辑，直接使用服务器名称和入口信息即可建立连接。

基本使用方法

  • 启动并连接 MCP 服务器后，客户端（LLM 客户端）可以通过标准的 JSON-RPC 请求向相应的 MCP 服务发起操作（如读取资源、调用工具、获取 Prompts），并接收 JSON-RPC 风格的响应。
  • 使用场景示例（概览）
    • 调用 Slack 相关功能：发送消息、上传/下载文件、读取历史等
    • 调度任务：创建、修改、审批任务，配合 Slack Emoji 进行批准
    • 资源与工具访问：网页抓取、搜索、浏览器自动化、GitHub 任务等
    • 记忆与系统提示：以工作区记忆和系统提示来丰富对话上下文
  • 安全与监控
    • 服务器端对密钥进行脱敏并在沙箱中执行，审计日志记录 tool 调用与结果
    • 对危险命令、凭证读取等进行 PreToolUse 层的策略阻止
    • CLAUDE.md 的完整性检查与回滚机制，确保核心配置不会被无意修改

维护与扩展

  • 该仓库已将多种 MCP 服务模块化为 src/mcp/ 子目录，新增工具或服务时可沿用相同的创建方式（createSdkMcpServer + tool 定义 + 钩子）。
  • 插件与技能机制支持将新的能力嵌入现有 MCP 服务中，便于扩展。
  • 运行时根据 .env 配置实现对模型、预算、心跳等参数的动态调整。

关键词 对话代理, 自动化工具, 会话记忆, 安全沙箱, Slack 集成

分类ID 6

服务器信息

访问项目