@esaio/esa-mcp-server

中文文档
0.15.2发布于 2026/10/30MITTypeScriptES Module构建来源已验证近 30 天下载 2.6万

Esa.io的官方MCP服务器 - STIO运输版本

中文使用文档
文档目录17 节
  1. (单位:千美元)
  2. 使えるツール
  3. チーム管理
  4. 記事管理
  5. 記事の操作
  6. コメント管理
  7. カテゴリー管理
  8. 添付ファイル
  9. ヘルプとドキュメント
  10. リソース
  11. プロンプト
  12. MCP 时间轴:
  13. 用意する環境変数
  14. 克劳德桌面QQ
  15. レジストリ
  16. リンク
  17. サポート

esa MCP 服务器

License: MIT

日本語 | 联合国

esa.io の公式 MCP(示范背景协议)サーバー (STDIO Transport 版)

(单位:千美元)

大赦国际 埃萨 校对:Soup。

使えるツール

チーム管理

  • esa_get_teams - 爱萨
  • esa_get_team_stats - チームの統計情報(メンバー数、記事数、コメント数など)
  • esa_get_team_tags - チーム内で使われているタグと使用回数
  • esa_get_team_members - チームメンバーとその役割・プロフィール

記事管理

  • esa_search_posts - 記事を検索
  • esa_get_post - 额 额 额 backlinks_count、本文の文字数・行数 body_md_stats を含む
  • esa_get_post_backlinks - 指定記事を参照している記事の一覧(ページング対応)
  • esa_create_post - 新しい記事を作成(タグ、カテゴリー、) タグ、カテゴリー、(タグ、カテゴリー、)
  • esa_update_post - 記事を更新(タイトル、本文、タグ、カテゴリー、) タイトル、本文、タグ、カテゴリー、(タイトル、本文、タグ、カテゴリー、)
  • esa_append_post - 記事本文の末尾に追記(既存本文を取得せずに追記でき、新しいリビジョンとして保存)
  • esa_prepend_post - 記事本文の先頭に追記(既存本文を取得せずに追記でき、新しいリビジョンとして保存)

記事の操作

  • esa_archive_post -
  • esa_ship_post - 飞船
  • esa_duplicate_post - 記事を複製(同じタイトル・本文の) WIP(記事を作成。別チームへの複製も可能)
  • esa_rollback_post_revision - 記事を指定したリビジョンにロールバック(復元した内容は新しいリビジョンとして保存。リビジョン番号は) esa_get_post の revision_number で確認可能

コメント管理

  • esa_get_comment - 额,额,额..
  • 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 エンコードで返却
    • QQ 强制签名 URL (QQ 5 Q) QQ

ヘルプとドキュメント

  • esa_get_search_options_help - esa
  • esa_get_markdown_syntax_help -埃萨・马克下
  • esa_search_help - esa

リソース

  • esa_recent_posts - 最近更新された記事の一覧
    • テンプレート: esa://teams/{teamName}/posts/recent
    • 贾森 贾森

プロンプト

  • esa_summarize_post - esa
    • 请检查ACCESS-DATE=中的日期值 (帮助)
    • 出力:記事の構造化された要約

MCP 时间轴:

(原始内容存档于2018-03-26) (英语). MCP QQ:

用意する環境変数

  • ESA ACESS TOKEN:
    • 必要なスコープ: read write または admin:comment read:post write:post read:category read:tag read:attachment read:team read:member
    • PAT v2 电影を推奨します。
  • 吴ANG:

克劳德桌面QQ

claude_desktop_config.json への追加方法:

++ 1 点球手 (++)

{
  "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"
      }
    }
  }
}

页:1数字 : /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" }]
}

registry.json 有问题吗 npm run build:registry CI失败了。

リンク

サポート


由埃萨队制作

版本与发布记录

@esaio/esa-mcp-server 共发布 35 个版本,首次发布于 2025/09/16;过去 12 个月发布了 27 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.15.2latest2026/10/3014 天前
0.15.12026/10/2915 天前
0.15.02026/10/1628 天前
0.14.12026/09/181 个月前
0.14.02026/08/182 个月前
0.13.02026/06/234 个月前

关于 @esaio/esa-mcp-server 的常见问题

@esaio/esa-mcp-server 是什么?

Esa.io的官方MCP服务器 - STIO运输版本

如何安装 @esaio/esa-mcp-server?

在项目目录运行 npm install @esaio/esa-mcp-server,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 esa-mcp-server,可以用 npx esa-mcp-server 直接运行。

@esaio/esa-mcp-server 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@esaio/esa-mcp-server 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@esaio/esa-mcp-server 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=24.14.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@esaio/esa-mcp-server 可以商用吗?

@esaio/esa-mcp-server 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@esaio/esa-mcp-server 的下载量有多少?

根据 npm 官方下载统计,@esaio/esa-mcp-server 在 2026/10/14 – 2026/11/12 这 30 天内被下载 26,326 次,日均约 878 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@esaio/esa-mcp-server 还在维护吗?

最新版本 0.15.2 发布于 2026/10/30(14 天前);至今共发布 35 个版本,其中过去 12 个月发布了 27 个;首次发布于 2025/09/16。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。