esa MCP サーバー

日本語

概要

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

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

リポジトリについて

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

設定

前提条件

• Node.js 18以上

• ESA APIアクセストークン

• ESAチーム名

インストール

環境変数の設定

MCP 構成例

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

サーバーの起動

利用可能なツール

この 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 投稿を作成した例です。

トラブルシューティング

アクセストークンの問題

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

権限の問題

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

ライセンス

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