ESA MCP Server

esaのAPIにアクセスするためのMCPサーバーです。

機能

このMCPサーバーは、esaのAPIを使用して以下の機能を提供します：

- チーム情報の取得
- 記事一覧の取得
- 記事詳細の取得
- 記事の作成
- 記事の更新
- コメント一覧の取得
- コメントの作成
- チーム統計情報の取得
- メンバー一覧の取得
- タグ一覧の取得
- カテゴリ情報の取得
- 認証中のユーザー情報の取得

セットアップ

1. 依存関係のインストール

bundle install

2. esaのアクセストークンを取得

1. esaにログインします
2. ユーザー設定ページ（https://[team].esa.io/user/applications）にアクセスします
3. 「Personal access tokens」セクションで「New Token」をクリックします
4. トークン名を入力し、スコープを選択します（read/writeの両方を選択することをお勧めします）
5. 「Create」ボタンをクリックします
6. 生成されたアクセストークンをコピーします

3. MCPサーバーの設定

esm-mcp-server以下に環境変数でアクセストークンとチーム名を設定します

その後、ClineのMCP設定ファイルを以下のように変更します

{
  "mcpServers": {
    "esa": {
      "command": "ruby",
      "args": ["/path/to/esa_mcp_server.rb"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

4. Clineの設定ファイルに追加

Clineの設定ファイルにesa_mcp_settings.jsonの内容を追加します：

- macOSの場合: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windowsの場合: %APPDATA%\Claude\claude_desktop_config.json
- Linuxの場合: ~/.config/Claude/claude_desktop_config.json
- VSCode拡張機能の場合: ~/.vscode-server/data/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

使用方法

ツール

以下のツールが利用可能です：

- get_team: チーム情報を取得します
- list_posts: 記事一覧を取得します
- get_post: 記事詳細を取得します
- create_post: 記事を作成します
- update_post: 記事を更新します
- list_comments: 記事のコメント一覧を取得します
- create_comment: コメントを作成します
- get_stats: チーム統計情報を取得します
- list_members: メンバー一覧を取得します
- list_tags: タグ一覧を取得します
- get_user: 認証中のユーザー情報を取得します

リソース

以下のリソースが利用可能です：

- categories://{category_name}: カテゴリ情報を取得します

例

チーム情報を取得する

<use_mcp_tool>
<server_name>esa</server_name>
<tool_name>get_team</tool_name>
<arguments>
{}
</arguments>
</use_mcp_tool>

記事一覧を取得する

<use_mcp_tool>
<server_name>esa</server_name>
<tool_name>list_posts</tool_name>
<arguments>
{
  "q": "category:開発",
  "page": 1,
  "per_page": 20,
  "sort": "updated",
  "order": "desc"
}
</arguments>
</use_mcp_tool>

記事を作成する

<use_mcp_tool>
<server_name>esa</server_name>
<tool_name>create_post</tool_name>
<arguments>
{
  "name": "新しい記事",
  "body_md": "# 新しい記事\n\nこれは新しい記事です。",
  "tags": ["タグ1", "タグ2"],
  "category": "開発/Ruby",
  "wip": true,
  "message": "新しい記事を作成"
}
</arguments>
</use_mcp_tool>

カテゴリ情報を取得する

```
<access_mcp_resource>
<server_name>esa</server_name>
<uri>categories://開発</uri>
</access_mcp_resource>