← 返回首页
Manual Setup

手动设置指南

pip install heropen 之后你的 agent 还需要连上 MCP 才能用。
选你的工具照着做，3 分钟搞定。

00 一键自动配置（推荐）

装完后先执行这个，大部分情况一步到位。

heropen auto-setup 自动

自动检测你机器上已安装的 Agent（Cline / Cursor / Windsurf / Claude Code 等），扫描它们的 MCP 配置文件并自动注入。

pip install heropen
heropen auto-setup
✅ 执行后重启你的 Agent，它就有记忆了。

如果 auto-setup 没有找到你的工具，或者你想手动指定，继续往下看。

01 MCP 配置长得什么样

所有 Agent 的 MCP 配置都是同一套 JSON 格式，只是文件路径和写法略有不同。

核心配置 标准格式

下面这段 JSON 就是告诉 agent：「启动一个叫 heropen 的命令，参数是 mcp，用标准输入输出通信」。 

{
  "mcpServers": {
    "heropen": {
      "command": "heropen",
      "args": ["mcp"],
      "disabled": false
    }
  }
}
💡 原理： Agent 启动 heropen-mcp 子进程，通过 stdin/stdout 交换工具调用。 所有 Agent 的都是这一套，只是文件放的位置不同。

02 WorkBuddy

Windows 端的 WorkBuddy 配置最简单。

配置文件 手动

  1. 打开路径 C:\Users\你的用户名\.workbuddy\
  2. 创建或编辑 mcp.json 文件
  3. 粘贴以下内容：
{
  "mcpServers": {
    "heropen": {
      "command": "heropen",
      "args": ["mcp"],
      "disabled": false
    }
  }
}
  1. 保存文件
  2. 完全关闭 WorkBuddy（任务栏退出，不只关窗口），重新打开
⚠️ 重要： 如果配置了多个 MCP 服务器（比如飞书 connector-proxy）， 把 heropen 放进去一起。

多 MCP 共存示例 示例

如果你同时用飞书 MCP 和 heropen：

{
  "mcpServers": {
    "connector-proxy": {
      "type": "http",
      "url": "http://127.0.0.1:59489/mcp",
      "description": "feishu MCP"
    },
    "heropen": {
      "command": "heropen",
      "args": ["mcp"],
      "disabled": false
    }
  }
}

03 Cline（VS Code 插件）

Cline 是 VS Code 里最流行的 MCP Agent 插件。

配置文件位置 手动

Windows： %APPDATA%\Claude\cline_mcp_settings.json
macOS： ~/Library/Application Support/Claude/cline_mcp_settings.json
Linux： ~/.config/Claude/cline_mcp_settings.json

打开对应文件，在 mcpServers 里加上：

{
  "mcpServers": {
    "heropen": {
      "command": "heropen",
      "args": ["mcp"],
      "disabled": false
    }
  }
}
✅ 保存后重启 VS Code，Cline 会自动加载。 在 Cline 对话里试试问「heropen 现在有多少条记忆」。

04 Cursor

Cursor 的 MCP 配置在项目级和全局级都可以。

全局配置 手动

  1. 打开 Cursor → Settings → Features → MCP Servers
  2. 点击「Add MCP Server」
  3. Name 填 heropen
  4. Type 选 command
  5. Command 填 heropen mcp
  6. 点 Save

或者直接编辑全局配置文件：

# macOS/Linux: ~/.cursor/mcp.json
# Windows: C:\Users\你的用户名\.cursor\mcp.json

{
  "mcpServers": {
    "heropen": {
      "command": "heropen",
      "args": ["mcp"],
      "disabled": false
    }
  }
}

05 Claude Code CLI

Claude Code 的项目级配置。

项目配置 手动

在项目根目录创建或编辑：

# .claude/settings.json（相对于项目根目录）
# 或者 ~/.claude/settings.json（全局）

{
  "mcpServers": {
    "heropen": {
      "command": "heropen",
      "args": ["mcp"],
      "disabled": false
    }
  }
}
✅ 保存后 Claude Code 下次启动自动加载。

06 Cherry Studio

Cherry Studio 直接在界面里配置。

界面配置 手动

  1. 打开 Cherry Studio → 设置 → MCP 客户端
  2. 点击「添加 MCP 服务器」
  3. 名称填 heropen
  4. 命令填 heropen
  5. 参数填 mcp
  6. 保存

或者直接编辑配置文件：

# Windows: %APPDATA%\CherryStudio\mcp.json
# macOS: ~/Library/Application Support/CherryStudio/mcp.json

{
  "mcpServers": {
    "heropen": {
      "command": "heropen",
      "args": ["mcp"],
      "disabled": false
    }
  }
}

07 Continue.dev

Continue 的全局配置文件。

全局配置 手动

# macOS/Linux: ~/.continue/config.json
# Windows: C:\Users\你的用户名\.continue\config.json

{
  "experimental": {
    "mcpServers": {
      "heropen": {
        "command": "heropen",
        "args": ["mcp"],
        "disabled": false
      }
    }
  }
}
⚠️ Continue 的 MCP 配置在 experimental 字段下。 如果已有其他 MCP 服务器，直接加在同一个对象里。

08 验证是否配置成功

不管用哪种方式配置，配好后在终端跑一下就能确认。

终端验证 确认

heropen status

如果显示记忆条数、agent 信息、运行状态，说明 heropen 正常工作。

🎯 完美验证： 在你的 agent 对话里问一句
「heropen 有多少条记忆？查一下」
能回答就成功了。

常见问题 排查

  1. 「MCP error -32000: Connection closed」 → 先检查是否装了 heropen 最新版（pip install --upgrade heropen），再确认 JSON 格式正确
  2. 「找不到命令 heropen」 → Python 没加到 PATH，用 python -m heropen mcp 代替
  3. 配置改完没生效 → 完全关闭 agent 再重开（不只关窗口）
  4. Windows 上 JSON 报错 → 文件存成 UTF-8 编码，不要用 UTF-8 with BOM