Harold Memory Sync MCP 服务器

关键词

知识管理客户关系管理任务协同自动化工作流数据持久化

使用说明（Markdown 格式）

  • 项目简介 Harold Memory Sync MCP 服务器是一套基于 MCP 的后端服务，专为 Harold 的知识库、CRM 集成与工作流工具而设计。它通过 MCP 协议向客户端提供对资源、工具和提示相关操作的访问能力，支持在 Claude Code 等环境中以标准化的方式查询、修改和扩展 Harold 的上下文与能力。

  • 主要功能点

    1. 资源/知识管理相关工具

      • harold_log：将重要决策、会议记录等日志追加到上下文日志（context-log.md）。
      • harold_fact：向 facts.md 的表格中新增或更新事实项。
      • harold_alert：在 alerts.md 中添加、更新或宣布警报，并支持历史归档。
      • harold_blocker：管理 Active/Resoled 的阻塞项，支持新增、更新、解决。
      • harold_event：对事件进行新增、更新与完成归档。
      • harold_read：读取 Harold 的知识库文件，用于快速查看。
      • harold_alerts_sync：运行警报引擎，综合事件、阻塞、CRM 信息等生成摘要警报。
      • harold_cadence_check / harold_blocker 把齐全的关系 Cadence（节奏/跟进）检查，与 CRM 数据对齐（存在 CRM 和老的 Cadence 表两种实现）。

    2. CRM 与任务集成工具

      • harold_log_interaction：记录与联系人之间的互动（电话、邮件、会议等）。
      • harold_upsert_contact：创建或更新联系人信息，并自动分配管线与阶段。
      • harold_search_contacts：按多字段过滤和全文搜索联系人。
      • harold_get_contact：获取联系人完整信息、互动历史、阶段历史等。
      • harold_crm_task：对联系人相关的 CRM 任务进行创建、更新、完成、取消、列出。

  • 安装步骤

    1. 安装依赖
      • 进入工具目录并安装依赖：tools/harold-mcp 目录执行 npm install。
    2. 配置 MCP 服务器（客户端需要）
      • 客户端需要通过 MCP 配置来启动该服务器。典型的配置如下（用于 MCP 客户端调用，后端由 Har o ld 提供实现，下面的配置仅作连接示例说明，不是服务器代码）： { "mcpServers": { "harold-mcp": { "type": "stdio", "command": "node", "args": ["tools/harold-mcp/server.js"], "env": { "SUPABASE_URL": "https://your-project.supabase.co", "SUPABASE_SERVICE_ROLE_KEY": "your-service-role-key" } } } } 说明：
      • type = "stdio" 表示通过标准输入/输出进行 JSON-RPC 通信。
      • command/args 指向实际运行 MCP 服务器的命令与参数。
      • env 变量用于连接 Supabase（CRM 数据源），含有 Supabase URL 与服务密钥。
    3. 启动与连接
      • MCP 客户端将按照上述配置启动 harold-mcp/server.js，并通过标准输入/输出与之进行通信。
      • 服务器依赖环境变量 SUPABASE_URL 与 SUPABASE_SERVICE_ROLE_KEY（若未设置，CRM 功能将不可用）。
  1. 运行与监控
    • 服务器运行需要 Node.js 环境，依赖在 tools/harold-mcp 目录内维护。
    • 可以参考仓库的 README 快速开始流程来配置 Supabase、安装依赖并启动。

  • 服务器使用方法

    • 使用 MCP 客户端（如 Claude Code 集成的对话环境）对 Harold 的上下文进行查询与操作，例如读取、写入知识库条目、创建联系人、添加任务等。
    • 对于需要长期记忆与上下文的任务，优先使用 harold_log、harold_fact、harold_read 等工具进行可追踪的写入与读取。
    • 针对 CRM 相关操作，优先使用 harold_upsert_contact、harold_search_contacts、harold_get_contact、harold_crm_task 以确保数据一致性。

  • 版本与运行信息

    • MCP 服务器名称: harold-memory-sync
    • 版本: 1.0.0
    • 传输模式: STDIO
    • 运行依赖: Node.js、Supabase

  • 基本注意事项

    • 需要在 Supabase 上配置数据库和表结构（如 contacts、 interactions、 tasks、 blocks 等，对应工具实现中的查询/写入）。
    • 环境变量需正确设置，未设置时相关功能会受限。
    • 服务器对话与工具实现均以 markdown 文件形式持久化，确保数据安全性与可追溯性。

  • 基本使用示例

    • 启动后，客户端可以通过 MCP 协议请求 harold-log、harold_fact、harold_get_contact 等工具来读取与写入 Harold 的上下文数据。
    • 对于 CRM 任务和联系人等数据变更，建议通过 harold_upsert_contact / harold_crm_task 等工具完成，以保持数据一致性。

  • 参考与扩展

    • 服务器还包含一个可视化仪表板模块（visualizer）用于实时查看活动与会话状态，便于运维与团队协作（需单独在服务器以 Node 运行可选功能）。

服务器信息

访问项目