@myhero/mcp-server

HERO 的 MCP 服务器 — 让 Claude Desktop、Cursor、Claude Code 以及任何 stdio MCP 客户端能够读取和写入您的 HERO 文档、项目和表格。

快速开始

将其添加到您的 AI 工具的 MCP 配置中：

{
  "mcpServers": {
    "hero": {
      "command": "npx",
      "args": ["-y", "@myhero/mcp-server"],
      "env": {
        "HERO_API_KEY": "hero_at_your_token_here"
      }
    }
  }
}

在 app.myhero.so → Settings → MCP Tokens 生成令牌。

有关 Claude Desktop、Cursor、Claude Code 等工具的分步设置，请参阅 myhero.so/mcp-setup 上的完整指南。

功能介绍

文档

• 读取任何文档 — 获取完整内容、纯文本、元数据或仅获取章节标题

• 在所有工作区和项目中进行搜索

• 创建新文档，重命名、移动、复制或删除它们

• 创建快照，列出文档中的每个块，通过编号跳转到特定章节

• 精确编辑：无需重写其余部分，即可使用完整的 HERO 块架构更改单个段落、标题、列表项或表格。

条款与法律结构

• 读取、列出和编辑合同与协议中的条款、子条款和定义

• 查找引用特定条款或定义术语的所有文档

• 直接从拥有该定义的文档中提取定义的解释

项目、文件夹和工作区

• 列出您的工作区、项目、文件夹以及其中的文档

• 创建项目，重命名它们，将文档整理到文件夹中

• 在项目之间批量移动或复制文档

表格

• 创建表格，添加或删除列和行，设置动态值。

• 读取整个表格，按名称查找特定的行、列或单元格

• 逐个或批量更新单元格

• 在文档内部引用行，使文档与表格保持同步

模板与占位符

• 构建可重用的文档模板，并使用从表格中提取数据的实时占位符

• 当底层表格数据发生变化时，所有引用它的文档都会自动更新

身份验证

两种身份验证方式：

1. 个人访问令牌 (HERO_API_KEY 环境变量) — 推荐用于无头（headless）设置。

2. OAuth 登录 — 省略环境变量，桥接程序会在首次使用时打开您的浏览器。令牌将保存到 ~/.hero/credentials.json。

在 app.myhero.so → Settings → MCP Tokens 管理和撤销令牌或会话。

环境变量

源码

源码位于 github.com/Unwynd-io/hero-mcp。欢迎提交问题和拉取请求。