Esa Mcp Server

What is Esa Mcp Server about?

Enables AI assistants to seamlessly browse, create, modify, and organize content on the esa.io information‑sharing platform through a set of predefined MCP tools.

How to use Esa Mcp Server?

1. Set environment variables – supply ESA_ACCESS_TOKEN (with required scopes) and optionally LANG for UI language.
2. Run the server – start the MCP server via Docker or the preferred npx command (see configuration below).
3. Configure the MCP client – add an entry for the server under mcpServers in the client’s configuration file, pointing to the command and environment variables.
4. Invoke tools – the client can call tools such as esa_get_teams, esa_create_post, esa_get_comment, etc., to perform operations on esa.

Key features of Esa Mcp Server

• Team management tools: list teams, statistics, tags, members.
• Post management: search, retrieve, create, update, archive, ship, duplicate.
• Comment management: get, create, update, delete, list with pagination.
• Category navigation: list categories, top‑level categories, all paths with filters.
• Attachment handling: retrieve images (base64) or signed URLs for larger files.
• Help utilities: search syntax, markdown syntax, documentation search.
• Resource shortcuts: recent posts template esa://teams/{teamName}/posts/recent.
• Prompt tool: esa_summarize_post for structured summarization of articles.

Use cases of Esa Mcp Server

• AI‑assisted documentation – a conversational assistant can fetch, summarize, and update project docs stored in esa.
• Automated reporting – scripts can generate summaries or status reports by pulling recent posts and statistics.
• Content moderation – AI can scan comments, flag inappropriate content, or auto‑reply.
• Knowledge base enrichment – assistants can suggest new posts or tags based on user queries.
• Workflow integration – combine with CI/CD pipelines to post build results or release notes directly to esa.

FAQ from the Esa Mcp Server

• Do I need Docker to run the server? No. You can run it with npx if Node.js is installed.
• Which scopes are required for the access token? read write or admin:comment read:post write:post read:category read:tag read:attachment read:team read:member.
• How are large attachments returned? As a signed URL valid for 5 minutes; images ≤30 MB are returned as base64.
• Can I change the language of responses? Set the LANG environment variable (e.g., ja or en).
• Where do I find tool documentation? Use esa_get_search_options_help, esa_get_markdown_syntax_help, and esa_search_help via the MCP client.

esa MCP Server

日本語 | 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
  • 出力: 記事の構造化された要約

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": "ja"
      }
    }
  }
}

オプション 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": "ja"
      }
    }
  }
}

注意: /path/to/your/node は which node で調べたパスに置き換えてください。

リンク

• esa.io - 情報共有サービス esa
• Model Context Protocol - MCP の詳細
• API ドキュメント - esa API リファレンス
• Claude Desktop - MCP 対応の AI アシスタント

サポート

• 📧 Support: Feedback Form
• 🐛 Issues: GitHub Issues
• 📖 Help: esa Docs

---

Made with ❤️ by the esa team