esa MCP サーバー

日本語で読む

概要

このサーバーは、モデルコンテキストプロトコル (MCP)を使用して、Claude AI がesa APIと対話できるようにするインターフェイスです。

この MCP サーバーを使用すると、Claude AI は esa ドキュメントの検索、作成、更新などの操作を実行できます。

リポジトリについて

このリポジトリは、esa MCPサーバーのスタンドアロン実装を提供します。Claude AIとesaを統合することで、ドキュメント管理を効率化します。

設定

前提条件

Node.js 18以上
ESA APIアクセストークン
ESAチーム名

インストール

# Install globally
npm install -g @kajirita2002/esa-mcp-server

# Or use directly with npx
npx @kajirita2002/esa-mcp-server

環境変数の設定

# Set environment variables
export ESA_ACCESS_TOKEN="your_esa_access_token"
export ESA_TEAM="your_team_name"

MCP 構成例

この MCP サーバーを使用している場合は、 mcp_config.jsonファイルに次の構成を追加します。

"esa": {
  "command": "npx",
  "args": ["-y", "@kajirita2002/esa-mcp-server"],
  "env": {
    "ESA_ACCESS_TOKEN": "your_esa_access_token",
    "ESA_TEAM": "your_team_name"
  }
}

サーバーの起動

# Start the server
npm start

利用可能なツール

この MCP サーバーは次のツールを提供します。

コメント関連

esa_list_comments
- 投稿のコメントリストを取得する
- 入力：
  - post_number (数字、必須): コメントを取得する投稿番号
  - page （数値、オプション）：取得するページ番号
  - per_page （数値、オプション）：ページあたりの結果数（最大：100）
esa_get_comment
- 具体的なコメントを取得する
- 入力：
  - comment_id （数値、必須）: 取得するコメントのID
  - include (文字列、オプション): レスポンスに含める関連データ（例: 'stargazers'）
esa_create_comment
- 記事にコメントを投稿する
- 入力：
  - post_number （数字、必須）: コメントする投稿番号
  - body_md (文字列、必須): コメント本文 (Markdown 形式)
  - user (文字列、オプション): 投稿者のスクリーン名 (チームオーナーのみが指定可能)

メンバー関連

esa_get_members
- チームメンバーのリストを取得する
- 入力：
  - page （数値、オプション）：取得するページ番号
  - per_page （数値、オプション）：ページあたりの結果数（最大：100）
esa_get_member
- 特定のチームメンバーに関する情報を取得する
- 入力：
  - screen_name_or_email (文字列、必須): 取得するメンバーのスクリーン名またはメールアドレス

使用例

以下は、Claude がこの MCP サーバーを使用して esa 投稿を作成した例です。

[Claude] Please create a new post in esa. The title should be "Project X Progress Report" and the body should include "# This Week's Progress\n\n- Implementation of Feature A completed\n- Testing of Feature B started\n\n## Next Week's Plan\n\n- Start implementation of Feature C".

[MCP Server] Using the esa_create_post tool to create a new post.

[Result]
{
  "number": 123,
  "name": "Project X Progress Report",
  "body_md": "# This Week's Progress\n\n- Implementation of Feature A completed\n- Testing of Feature B started\n\n## Next Week's Plan\n\n- Start implementation of Feature C",
  "wip": false,
  "created_at": "2023-06-01T12:34:56+09:00",
  "updated_at": "2023-06-01T12:34:56+09:00",
  "url": "https://your-team.esa.io/posts/123"
}

[Claude] The post has been created successfully. The post number is 123, and you can access it at the following URL:
https://your-team.esa.io/posts/123

トラブルシューティング

アクセストークンの問題

Error: Request failed with status code 401

このエラーが表示された場合、esaアクセストークンが無効または期限切れになっている可能性があります。esa設定画面から新しいアクセストークンを生成し、環境変数を更新してください。

権限の問題

Error: Request failed with status code 403

このエラーが表示された場合、現在のアクセストークンには必要な権限がありません。esa設定画面でアクセストークンの権限を確認し、必要に応じて新しいトークンを発行してください。

ライセンス

MIT ライセンスに基づいて提供されます。

esa MCP Server