Esa MCP Server

[!IMPORTANT] An official MCP server has been released. Please use the official server going forward.

• esa公式のローカルMCPサーバーを公開しました - ReleaseNotes/2025/09/17 - docs.esa.io

esa MCP Server

A Model Context Protocol (MCP) server for esa.io.

Table of Contents

• Usage
  • Prerequisites
  • Configuration
    • Using npx
    • Using Docker
  • Read-only Mode
• MCP Tools
  • Posts
  • Tags
  • Comments
• License

Usage

Prerequisites

Before using this MCP server, you need to generate a personal access token from your esa.io team:

1. Go to https://<TEAM_NAME>.esa.io/user/applications
2. Create a new personal access token
3. Copy the token for configuration

Configuration

You can run the server either via npx or Docker.

Using npx

Add the following configuration to your MCP client:

{
  "mcpServers": {
    "esa": {
      "command": "npx",
      "args": [
        "-y",
        "@koki-develop/esa-mcp-server@latest"
      ],
      "env": {
        "ESA_TEAM": "<your-team-name>",
        "ESA_ACCESS_TOKEN": "<your-personal-access-token>"
      }
    }
  }
}

Replace <your-team-name> and <your-personal-access-token> with your team name and personal access token.

Using Docker

If you prefer Docker, use the following configuration:

{
  "mcpServers": {
    "esa": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ESA_TEAM",
        "-e",
        "ESA_ACCESS_TOKEN",
        "ghcr.io/koki-develop/esa-mcp-server:latest"
      ],
      "env": {
        "ESA_TEAM": "<your-team-name>",
        "ESA_ACCESS_TOKEN": "<your-personal-access-token>"
      }
    }
  }
}

Read-only Mode

To enable read-only mode that only allows read operations, add the --readonly flag.

Using npx:

{
  "mcpServers": {
    "esa": {
      "command": "npx",
      "args": [
        "-y",
        "@koki-develop/esa-mcp-server@latest",
        "--readonly"
      ],
      "env": {
        "ESA_TEAM": "<your-team-name>",
        "ESA_ACCESS_TOKEN": "<your-personal-access-token>"
      }
    }
  }
}

Using Docker:

{
  "mcpServers": {
    "esa": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ESA_TEAM",
        "-e",
        "ESA_ACCESS_TOKEN",
        "ghcr.io/koki-develop/esa-mcp-server:latest",
        "--readonly"
      ],
      "env": {
        "ESA_TEAM": "<your-team-name>",
        "ESA_ACCESS_TOKEN": "<your-personal-access-token>"
      }
    }
  }
}

In read-only mode, only the following operations are available:

• get_posts - retrieve posts
• get_post - retrieve a specific post
• get_tags - retrieve tags
• get_post_comments - retrieve post comments

Write operations (create_post, update_post, delete_post, create_post_comment, update_comment, delete_comment) are disabled.

MCP Tools

• Posts
• Tags
• Comments

Posts

Tags

Comments

License

This project is licensed under the MIT License - see the LICENSE file for details.

Copyright (c) 2025 Koki Sato