esa MCP Server

公式

esa.io向け公式Model Context Protocol (MCP)サーバー - STDIOトランスポート版。

Esa MCPで何ができますか?

  • 投稿の検索と閲覧 — esa_search_posts で投稿を検索し、番号を指定して esa_get_post で取得すると、被リンク数と本文の統計を確認できます。
  • コンテンツの作成と編集 — esa_create_post で投稿を作成し、esa_update_post で更新できます。また、esa_append_post と esa_prepend_post を使ってテキストを末尾または先頭に追加できます。
  • 投稿のライフサイクル管理 — esa_ship_post で投稿を公開し、esa_archive_post でアーカイブし、esa_duplicate_post で複製できます。または、以前のリビジョンに戻すこともできます。
  • コメントの管理 — 投稿またはチームのコメントを一覧表示し、esa_create_comment、esa_update_comment、esa_delete_comment で作成、更新、削除できます。
  • カテゴリとチームの確認 — esa_get_all_category_paths でカテゴリのパスを確認し、esa_get_team_stats と esa_get_team_members でチームの詳細を確認できます。
  • 投稿の要約 — esa_summarize_post プロンプトを使うと、指定したチームの投稿を構造化された形式で要約できます。

ドキュメント

esa MCP Server

License: MIT

日本語 | 英語

esa.io 向けの公式 Model Context Protocol (MCP) サーバー - STDIO トランスポート版。

概要

この MCP サーバーは、AI アシスタントと、共同ドキュメントプラットフォームである esa.io をシームレスに連携します。Model Context Protocol を通じて、AI アシスタントが esa のドキュメントを直接読み取り、作成、更新、管理できるようにします。

利用可能なツール

チーム管理

  • esa_get_teams - ユーザーがアクセスできる esa チームを取得
  • esa_get_team_stats - チームの統計情報を取得(メンバー、投稿、コメント、スター、ウォッチ、アクティブユーザー)
  • esa_get_team_tags - チームの投稿で使用されているすべてのタグを件数とともに取得
  • esa_get_team_members - 役割とプロフィール情報を含むチームメンバーを取得

投稿管理

  • esa_search_posts - esa.io の投稿を検索
  • esa_get_post - 投稿番号で特定の投稿を取得(本文の文字数と行数を含む backlinks_count および body_md_stats を含む)
  • esa_get_post_backlinks - 特定の投稿を参照している投稿をページネーション付きで一覧表示
  • esa_create_post - タグ、カテゴリ、WIP ステータスを指定して新しい投稿を作成
  • esa_update_post - 既存の投稿を更新(タイトル、内容、タグ、カテゴリ、WIP ステータス)
  • esa_append_post - 投稿本文の末尾に内容を追加(現在の本文を取得する必要はありません。新しいリビジョンとして保存されます)
  • esa_prepend_post - 投稿本文の先頭に内容を追加(現在の本文を取得する必要はありません。新しいリビジョンとして保存されます)

投稿アクション

  • esa_archive_post - 投稿を Archived/ カテゴリに移動してアーカイブ
  • esa_ship_post - 投稿を Ship する(wip を false に設定して完了としてマーク)
  • esa_duplicate_post - 投稿を複製(同じタイトルと本文で新しい WIP 投稿を作成。チームをまたいだ複製にも対応)
  • esa_rollback_post_revision - 投稿を指定したリビジョンにロールバック(復元した内容は新しいリビジョンとして保存されます。リビジョン番号は esa_get_post の revision_number で確認してください)

コメント管理

  • esa_get_comment - ID で特定のコメントを取得
  • esa_create_comment - 投稿に新しいコメントを作成
  • esa_update_comment - 既存のコメントを更新
  • esa_delete_comment - コメントを削除
  • esa_get_post_comments - 特定の投稿のコメントをページネーション付きで取得
  • esa_get_team_comments - チームのコメントをページネーション付きで取得

カテゴリ管理

  • esa_get_categories - 特定のパスのカテゴリとサブカテゴリを取得
  • esa_get_top_categories - チームの最上位カテゴリをすべて取得
  • esa_get_all_category_paths - チーム内のすべてのカテゴリパスを取得(投稿数を含み、フィルタリングに対応)
    • カテゴリ構造の把握、整理計画、クリーンアップに最適
    • フィルタの例: 開発関連は prefix: "dev"、API 関連カテゴリは match: "api"

添付ファイル

  • esa_get_attachment - esa の投稿やコメントから添付ファイルを取得
    • 30MB 未満の対応画像(JPEG、PNG、GIF、WebP)は base64 エンコードされたデータを返します
    • その他のファイル形式、大きな画像、または forceSignedUrl が指定された場合は、署名付き URL(有効期間 5 分)を返します

ヘルプとドキュメント

  • esa_get_search_options_help - esa の検索構文ドキュメントを取得
  • esa_get_markdown_syntax_help - esa の Markdown 構文ドキュメントを取得
  • esa_search_help - 機能や用語について esa のドキュメントを検索

利用可能なリソース

  • esa_recent_posts - esa チームの最近更新された投稿を取得
    • テンプレート: esa://teams/{teamName}/posts/recent
    • 戻り値: 最近更新された投稿の JSON リスト

利用可能なプロンプト

  • esa_summarize_post - esa の投稿内容を要約
    • 入力: チーム名と投稿番号
    • 出力: 投稿内容の構造化された要約

MCP クライアントの設定

MCP クライアントの設定ファイルに追加します。

必須の環境変数

  • ESA_ACCESS_TOKEN: アクセストークン
    • 必須スコープ: read write または admin:comment read:post write:post read:category read:tag read:attachment read:team read:member
    • PAT v2 を推奨します。
  • LANG: UI の言語

Claude Desktop の例

claude_desktop_config.json に追加します。

オプション 1: Docker(推奨)

{
  "mcpServers": {
    "esa": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ESA_ACCESS_TOKEN",
        "-e",
        "LANG",
        "ghcr.io/esaio/esa-mcp-server"
      ],
      "env": {
        "ESA_ACCESS_TOKEN": "your_personal_access_token",
        "LANG": "en"
      }
    }
  }
}

オプション 2: npx

{
  "mcpServers": {
    "esa": {
      "command": "/Users/your-username/.nodenv/shims/npx",
      "args": ["@esaio/esa-mcp-server"],
      "env": {
        "ESA_ACCESS_TOKEN": "your_personal_access_token",
        "LANG": "en"
      }
    }
  }
}

注: /path/to/your/node を which node コマンドの出力に置き換えてください。

レジストリ

このパッケージには、パッケージのルートに registry.json が含まれており、登録済みのツール、リソース、プロンプトを公開しています。サーバーを起動せずに、プログラムから利用できます。

import registry from "@esaio/esa-mcp-server/registry.json" with {
  type: "json",
};

スキーマ:

{
  "tools": [{ "name": "esa_get_teams" }, "..."],
  "resources": [
    {
      "name": "esa_recent_posts",
      "uriTemplate": "esa://teams/{teamName}/posts/recent"
    }
  ],
  "prompts": [{ "name": "esa_summarize_post" }]
}

このファイルは npm run build:registry によって再生成され、CI チェックによって登録済みの項目との同期が保たれていることが検証されます。

リンク

サポート


esa チームが ❤️ を込めて作成