esa MCP Server

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