# @esaio/esa-mcp-server 中文文档 规范地址：https://npmcn.com/package/%40esaio/esa-mcp-server/ 版本：0\.15\.2 npm 元数据更新时间：2026-10-30T00:01:59.374Z 中文译文更新时间：2026-11-13T21:50:38.288Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40esaio/esa-mcp-server 原文对照：https://npmcn.com/package/%40esaio/esa-mcp-server/?lang=original 项目主页：https://github.com/esaio/esa-mcp-server#readme 源码仓库：https://github.com/esaio/esa-mcp-server ## 关键信息（来自 npm 元数据） - 包体积（解压后）：184 kB，31 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - Node.js 要求：\>=24\.14\.0 - 运行依赖：4 个 - 首次发布：2025-09-16T04:40:01.826Z - 最新版本发布：2026-10-30T00:01:59.012Z - 近 30 天下载量：26326（2026-10-14 至 2026-11-12，npm 官方下载统计） - 已发布版本数：35（近 12 个月 27 个） ## 中文简介 Esa.io的官方MCP服务器 - STIO运输版本 ## 安装 ```sh npm install @esaio/esa-mcp-server ``` 也可以使用：`pnpm add @esaio/esa-mcp-server`、`yarn add @esaio/esa-mcp-server`、`bun add @esaio/esa-mcp-server` ## README # esa MCP 服务器 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) **日本語** | [联合国](https://github.com/esaio/esa-mcp-server/blob/main/README.en.md) esa.io の公式 MCP(示范背景协议)サーバー (STDIO Transport 版) ## (单位:千美元) 大赦国际 [埃萨](https://esa.io/) 校对: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 电影](https://docs.esa.io/posts/559)を推奨します。 - 吴ANG: ### 克劳德桌面QQ `claude_desktop_config.json` への追加方法: #### ++ 1 点球手 (++) ```json { "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 ```json { "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` /リソース/プロンプトの一覧を公開しています。サーバーを起動せずにプログラムから読み取れます: ```js import registry from "@esaio/esa-mcp-server/registry.json" with { type: "json", }; ``` スキーマ: ```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失败了。 ## リンク - [埃萨.io](https://esa.io/) - 伊萨 - [示范背景协议](https://modelcontextprotocol.io/) - MCP —— —— —— - [API —— ——](https://docs.esa.io/posts/102) - 爱滋 - 爱滋 - [克劳德桌面](https://claude.ai/download) - MCP 爱尔 ## サポート - • 支持: [反馈表单](https://esa.io/feedbacks/new) - 问题: [GitHub 问题](https://github.com/esaio/esa-mcp-server/issues) - 帮助 : [医生](https://docs.esa.io/) * * * 由埃萨队制作 ## 常见问题 ### @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 和提交记录判断。