esa MCP サーバー

日本語で読む

概要

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

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

Related MCP server: ESA MCP Server

リポジトリについて

このリポジトリは、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 サーバーは次のツールを提供します。

関連投稿

1. esa_list_posts

   • チーム内の投稿リストを取得する

   • 入力：

     • q (文字列、オプション): 検索クエリ

     • include (文字列、オプション): レスポンスに含める関連データ（例: 'comments,stargazers'）

     • sort (文字列、オプション): ソート方法 (updated、created、number、stars、watches、comments、best_match)

     • order (文字列、オプション): 並べ替え順 (desc, asc)

     • per_page （数値、オプション）：ページあたりの結果数（最大：100）

     • page （数値、オプション）：取得するページ番号

2. esa_get_post

   • 特定の投稿に関する詳細情報を取得する

   • 入力：

     • post_number (数値、必須): 取得する投稿番号

     • include (文字列、オプション): レスポンスに含める関連データ（例: 'comments,stargazers'）

3. esa_create_post

   • 新しい投稿を作成する

   • 入力：

     • name (文字列、必須): 投稿タイトル

     • body_md (文字列、オプション): 投稿本文 (Markdown 形式)

     • tags (文字列の配列、オプション): 投稿のタグのリスト

     • category (文字列, オプション): 投稿のカテゴリー

     • wip (ブール値、オプション、デフォルト: true): WIP (作業中) としてマークするかどうか

     • message （文字列、オプション）：メッセージを変更する

     • user (文字列、オプション): 投稿者のスクリーン名 (チームオーナーのみが指定可能)

     • template_post_id (数値、オプション): テンプレートとして使用する投稿のID

4. esa_update_post

   • 既存の投稿を更新する

   • 入力：

     • post_number （数値、必須）: 更新する投稿番号

     • name (文字列、オプション): 投稿の新しいタイトル

     • body_md (文字列、オプション): 投稿の新しい本文 (Markdown 形式)

     • tags (文字列の配列、オプション): 投稿のタグの新しいリスト

     • category （文字列、オプション）: 投稿の新しいカテゴリ

     • wip (ブール値、オプション): WIP (作業中) としてマークするかどうか

     • message （文字列、オプション）: メッセージを変更する

     • created_by (文字列、オプション): 投稿者のスクリーン名 (チームオーナーのみが指定可能)

     • original_revision （文字列、オプション）：更新の基準となるリビジョン

コメント関連

1. esa_list_comments

   • 投稿のコメントリストを取得する

   • 入力：

     • post_number (数字、必須): コメントを取得する投稿番号

     • page （数値、オプション）：取得するページ番号

     • per_page （数値、オプション）：ページあたりの結果数（最大：100）

2. esa_get_comment

   • 具体的なコメントを取得する

   • 入力：

     • comment_id （数値、必須）: 取得するコメントのID

     • include (文字列、オプション): レスポンスに含める関連データ（例: 'stargazers'）

3. esa_create_comment

   • 記事にコメントを投稿する

   • 入力：

     • post_number （数字、必須）: コメントする投稿番号

     • body_md (文字列、必須): コメント本文 (Markdown 形式)

     • user (文字列、オプション): 投稿者のスクリーン名 (チームオーナーのみが指定可能)

メンバー関連

1. esa_get_members

   • チームメンバーのリストを取得する

   • 入力：

     • page （数値、オプション）：取得するページ番号

     • per_page （数値、オプション）：ページあたりの結果数（最大：100）

2. 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 ライセンスに基づいて提供されます。