@esaio/esa-mcp-server 0.2.0 → 0.2.1

package/README.en.md

@@ -13,6 +13,7 @@ This MCP server provides seamless integration between AI assistants and [esa.io]
 ## Available Tools
 
 ### Team Management
+
 - `esa_get_teams` - Get user's accessible esa teams
 - `esa_get_team_stats` - Get team statistics (members, posts, comments, stars, watches, active users)
 - `esa_get_team_tags` - Get all tags used in team posts with count
@@ -26,11 +27,13 @@ This MCP server provides seamless integration between AI assistants and [esa.io]
 - `esa_update_post` - Update existing post (title, content, tags, category, WIP status)
 
 ### Post Actions
+
 - `esa_archive_post` - Archive a post by moving to Archived/ category
 - `esa_ship_post` - Ship a post (mark as complete by setting wip to false)
 - `esa_duplicate_post` - Prepare a post for duplication (retrieve name and body_md)
 
 ### Comment Management
+
 - `esa_get_comment` - Get a specific comment by ID
 - `esa_create_comment` - Create a new comment on a post
 - `esa_update_comment` - Update an existing comment
@@ -39,6 +42,7 @@ This MCP server provides seamless integration between AI assistants and [esa.io]
 - `esa_get_team_comments` - Get team comments with pagination
 
 ### Category Management
+
 - `esa_get_categories` - Get categories and subcategories for a specific path
 - `esa_get_top_categories` - Get all top-level categories for a team
 - `esa_get_all_category_paths` - Get all category paths in a team (with post counts, supports filtering)
@@ -46,11 +50,13 @@ This MCP server provides seamless integration between AI assistants and [esa.io]
   - Filter examples: `prefix: "dev"` for development-related, `match: "api"` for API-related categories
 
 ### Attachments
+
 - `esa_get_attachment` - Retrieve an attachment file from esa posts and comments
   - Returns base64-encoded data for supported images (JPEG, PNG, GIF, WebP) under 30MB
   - Returns signed URLs (valid for 5 minutes) for other file types, larger images, or when forceSignedUrl is specified
 
 ### Help & Documentation
+
 - `esa_get_search_options_help` - Get esa search syntax documentation
 - `esa_get_markdown_syntax_help` - Get esa Markdown syntax documentation
 - `esa_search_help` - Search esa documentation for features and terminology
@@ -74,8 +80,8 @@ Add to your MCP client configuration file:
 ### Required Environment Variables
 
 - ESA_ACCESS_TOKEN: Access Token
-   - Required scopes: `read write` or `admin:comment read:post write:post read:category read:tag read:team read:member`
-   - [PAT v2](https://docs.esa.io/posts/559) is recommended.
+  - Required scopes: `read write` or `admin:comment read:post write:post read:category read:tag read:attachment read:team read:member`
+  - [PAT v2](https://docs.esa.io/posts/559) is recommended.
 - LANG: Language for UI
 
 ### Claude Desktop Example
@@ -115,9 +121,7 @@ Add to `claude_desktop_config.json`:
   "mcpServers": {
     "esa": {
       "command": "/Users/your-username/.nodenv/shims/npx",
-      "args": [
-        "@esaio/esa-mcp-server"
-      ],
+      "args": ["@esaio/esa-mcp-server"],
       "env": {
         "ESA_ACCESS_TOKEN": "your_personal_access_token",
         "LANG": "en"

package/README.md

@@ -4,7 +4,7 @@
 
 **日本語** | [English](README.en.md)
 
-esa.io の公式 MCP(Model Context Protocol)サーバー(STDIO Transport版)
+esa.io の公式 MCP(Model Context Protocol)サーバー(STDIO Transport 版)
 
 ## 概要
 
@@ -13,6 +13,7 @@ AI アシスタントと情報共有サービス [esa](https://esa.io) をつな
 ## 使えるツール
 
 ### チーム管理
+
 - `esa_get_teams` - 所属している esa チームの一覧
 - `esa_get_team_stats` - チームの統計情報（メンバー数、記事数、コメント数など）
 - `esa_get_team_tags` - チーム内で使われているタグと使用回数
@@ -21,16 +22,18 @@ AI アシスタントと情報共有サービス [esa](https://esa.io) をつな
 ### 記事管理
 
 - `esa_search_posts` - 記事を検索
-- `esa_get_post` - 記事IDから記事を取得
+- `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` - コメントを編集
@@ -39,18 +42,21 @@ AI アシスタントと情報共有サービス [esa](https://esa.io) をつな
 - `esa_get_team_comments` - チーム全体のコメント一覧（ページング対応）
 
 ### カテゴリー管理
+
 - `esa_get_categories` - 指定パス配下のカテゴリー一覧
 - `esa_get_top_categories` - トップレベルのカテゴリー一覧
 - `esa_get_all_category_paths` - チーム内の全カテゴリーパス一覧（記事数付き、フィルタリング対応）
   - カテゴリ構造の把握、整理、統合の計画に最適
-  - フィルター例: `prefix: "dev"` で開発関連、`match: "api"` でAPI関連を検索
+  - フィルター例: `prefix: "dev"` で開発関連、`match: "api"` で API 関連を検索
 
 ### 添付ファイル
+
 - `esa_get_attachment` - 記事やコメントの添付ファイルを取得
-  - サポート形式（JPEG, PNG, GIF, WebP）で30MB以下の画像はbase64エンコードで返却
-  - その他のファイル、大きな画像、またはforceSignedUrl指定時は署名付きURL（有効期限5分）を返却
+  - サポート形式（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 のドキュメントから機能や用語を検索
@@ -64,7 +70,7 @@ AI アシスタントと情報共有サービス [esa](https://esa.io) をつな
 ## プロンプト
 
 - `esa_summarize_post` - esa の記事を要約
-  - 入力: チーム名と記事ID
+  - 入力: チーム名と記事 ID
   - 出力: 記事の構造化された要約
 
 ## MCP クライアントの設定
@@ -74,8 +80,8 @@ MCP クライアントの設定ファイルに以下を追加します：
 ### 用意する環境変数
 
 - ESA_ACCESS_TOKEN: アクセストークン
-   - 必要なスコープ: `read write` または `admin:comment read:post write:post read:category read:tag read:team read:member`
-   - [PAT v2](https://docs.esa.io/posts/559)を推奨します。
+  - 必要なスコープ: `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)を推奨します。
 - LANG: UI の言語設定
 
 ### Claude Desktop の例
@@ -115,9 +121,7 @@ MCP クライアントの設定ファイルに以下を追加します：
   "mcpServers": {
     "esa": {
       "command": "/Users/your-username/.nodenv/shims/npx",
-      "args": [
-        "@esaio/esa-mcp-server"
-      ],
+      "args": ["@esaio/esa-mcp-server"],
       "env": {
         "ESA_ACCESS_TOKEN": "your_personal_access_token",
         "LANG": "ja"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esaio/esa-mcp-server",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Official MCP server for esa.io - STDIO transport version",
   "main": "bin/index.js",
   "type": "module",