esa-mcp-server

[](https://opensource.org/licenses/MIT)

日本語 | English

esa.io の公式 MCP(Model Context Protocol)サーバー(STDIO Transport 版)

AI アシスタントと情報共有サービス esa をつなぐ MCP サーバーです。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_get_post - 記事 ID から記事を取得
• esa_create_post - 新しい記事を作成（タグ、カテゴリー、WIP ステータス付き）
• esa_update_post - 記事を更新（タイトル、本文、タグ、カテゴリー、WIP ステータス）

• esa_archive_post - 記事をアーカイブ（Archived/ カテゴリーへ移動）
• esa_ship_post - 記事を Ship It!（WIP を外して公開）
• esa_duplicate_post - 記事を複製するための準備（タイトルと本文を取得）

• 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" で開発関連、match: "api" で API 関連を検索

• esa_get_attachment - 記事やコメントの添付ファイルを取得
• サポート形式（JPEG, PNG, GIF, WebP）で 30MB 以下の画像は 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://teams/{teamName}/posts/recent
• 戻り値: 最近更新された記事の JSON リスト

• esa_summarize_post - esa の記事を要約
• 入力: チーム名と記事 ID
• 出力: