@myhero/mcp-server

HERO 用のMCPサーバーです。Claude Desktop、Cursor、Claude Code、およびその他のstdio MCPクライアントなどのAIツールが、HEROのドキュメント、プロジェクト、テーブルを読み書きできるようにします。

クイックスタート

AIツールのMCP設定に追加してください：

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

app.myhero.so → 設定 → MCPトークン でトークンを生成します。

Claude Desktop、Cursor、Claude Codeなどでのステップバイステップのセットアップについては、myhero.so/mcp-setup の完全ガイド を参照してください。

機能

ドキュメント

• ドキュメントの読み取り — 全文、プレーンテキスト、メタデータ、またはセクションタイトルのみの取得

• すべてのワークスペースとプロジェクトを横断した検索

• ドキュメントの新規作成、名前変更、移動、複製、削除

• スナップショットの取得、ドキュメント内の全ブロックのリスト表示、番号によるセクションへのジャンプ

• 局所的な編集：HEROブロックスキーマを使用して、他の部分を書き換えることなく、特定の段落、見出し、リスト項目、またはテーブルを変更可能。

条項と法的構造

• 契約書や合意書内の条項、サブ条項、定義の読み取り、リスト表示、編集

• 特定の条項や定義語を参照しているすべてのドキュメントを検索

• 定義の所有元ドキュメントから直接、定義の説明を取得

プロジェクト、フォルダ、ワークスペース

• ワークスペース、プロジェクト、フォルダ、およびその中のドキュメントをリスト表示

• プロジェクトの作成、名前変更、ドキュメントのフォルダへの整理

• プロジェクト間でのドキュメントの一括移動やコピー

テーブル

• テーブルの作成、列や行の追加・削除、動的な値の設定

• テーブル全体の読み取り、名前による特定の行、列、セルの検索

• セルの更新（個別または一括）

• ドキュメント内から行を参照し、ドキュメントとテーブルの同期を維持

テンプレートとプレースホルダー

• テーブルからデータを取得するライブプレースホルダーを備えた再利用可能なドキュメントテンプレートの構築

• 基盤となるテーブルデータが変更されると、それを参照するすべてのドキュメントが自動的に更新

認証

認証には2つの方法があります：

1. パーソナルアクセストークン (HERO_API_KEY 環境変数) — ヘッドレスセットアップに推奨。

2. OAuthログイン — 環境変数を省略すると、初回使用時にブラウザが起動します。トークンは ~/.hero/credentials.json に保存されます。

トークンやセッションの管理・取り消しは app.myhero.so → 設定 → MCPトークン から行えます。

環境変数

ソース

ソースコードは github.com/Unwynd-io/hero-mcp にあります。Issueやプルリクエストを歓迎します。