esa-mcp-server

esa-mcp-server

3.2

If you are the rightful owner of esa-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

ESA MCP Server provides access to ESA's API for various operations.

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>