ESA MCP

v0.3.2Cloud Servicesstable

An implementation of the Model Context Protocol server that enables AI models to communicate with Edge Security Acceleration (ESA) services, allowing models to manage routines, deployments, routes, records, and sites through standardized protocols.

esa-mcp-servermcpai-integration
Share:
36
Stars
0
Downloads
0
Weekly
0/5

What is ESA MCP?

ESA MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to implementation of the model context protocol server that enables ai models to communicate with edge security acceleration (esa) services, allowing models to manage routines, deployments, routes, recor...

An implementation of the Model Context Protocol server that enables AI models to communicate with Edge Security Acceleration (ESA) services, allowing models to manage routines, deployments, routes, records, and sites through standardized protocols.

This server falls under the Cloud Services and APIs categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • get_posts
  • get_post
  • create_post
  • update_post
  • delete_post

Use Cases

Manage Edge Security Acceleration services through standardized MCP protocols.
Deploy and configure routines, routes, records and sites via AI models.
Automate ESA operations using natural language through MCP interface.
koki-develop

Maintainer

LicenseMIT License
Languagetypescript
Versionv0.3.2
UpdatedSep 11, 2025
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y @koki-develop/esa-mcp-server

Manual Installation

npx -y @koki-develop/esa-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use ESA MCP

The esa MCP Server connects AI assistants to esa.io, a team knowledge base and documentation platform popular in Japanese development teams. It exposes tools for managing posts, tags, and comments — covering the full create-read-update-delete lifecycle — so Claude and other AI assistants can search posts, draft documentation, add comments, and organize team knowledge directly through natural language. Teams use it to let AI automatically update wikis, draft release notes, or search through accumulated team documentation without switching to the esa.io web interface.

Prerequisites

  • Node.js installed (for npx usage) or Docker
  • An esa.io account with access to a team
  • ESA_TEAM: your esa.io team name (the subdomain, e.g. 'myteam' from myteam.esa.io)
  • ESA_ACCESS_TOKEN: a personal access token generated at https://<your-team>.esa.io/user/applications
  • An MCP-compatible client such as Claude Desktop or Cursor
1

Generate an esa.io access token

Log in to your esa.io team and navigate to https://<your-team-name>.esa.io/user/applications. Click 'Generate new token', give it a name, and select the required scopes (read and write for posts and comments). Save the token value — it will only be shown once.

2

Note your team name

Your team name is the subdomain of your esa.io URL. For example, if your team URL is https://acme.esa.io, your team name is 'acme'.

3

Test with npx

Run the server directly with npx, passing your team name and access token as environment variables.

ESA_TEAM=myteam ESA_ACCESS_TOKEN=your_token npx -y @koki-develop/esa-mcp-server
4

Configure your MCP client

Add the esa MCP server to your Claude Desktop configuration.

{
  "mcpServers": {
    "esa": {
      "command": "npx",
      "args": ["-y", "@koki-develop/esa-mcp-server"],
      "env": {
        "ESA_TEAM": "your-team-name",
        "ESA_ACCESS_TOKEN": "your_access_token"
      }
    }
  }
}
5

Use read-only mode for safe access (optional)

If you want to prevent the AI from creating, updating, or deleting posts, add the --readonly flag to the args array. This disables all write operations.

{
  "mcpServers": {
    "esa": {
      "command": "npx",
      "args": ["-y", "@koki-develop/esa-mcp-server", "--readonly"],
      "env": {
        "ESA_TEAM": "your-team-name",
        "ESA_ACCESS_TOKEN": "your_access_token"
      }
    }
  }
}

ESA MCP Examples

Client configuration

Claude Desktop configuration for the esa MCP server with write access enabled.

{
  "mcpServers": {
    "esa": {
      "command": "npx",
      "args": ["-y", "@koki-develop/esa-mcp-server"],
      "env": {
        "ESA_TEAM": "acme",
        "ESA_ACCESS_TOKEN": "your_esa_personal_access_token"
      }
    }
  }
}

Prompts to try

Example prompts for searching and managing esa.io team documentation.

- "Search for all posts tagged 'release-notes' in our esa team"
- "Create a new post in the Engineering category titled 'v2.5.0 Release Notes'"
- "Show me the full content of post number 42"
- "Add a comment to post 15 asking for clarification on the deployment steps"
- "List all tags used in our team knowledge base"
- "Update post 99 to change the status from WIP to Shipped"

Troubleshooting ESA MCP

401 Unauthorized errors when accessing esa.io API

Verify that ESA_ACCESS_TOKEN is correct and that the token has not expired or been revoked. Regenerate the token at https://<your-team>.esa.io/user/applications and update your configuration.

Posts not found or wrong team data returned

Confirm that ESA_TEAM matches exactly the subdomain of your esa.io team URL (without .esa.io). The team name is case-sensitive.

Write operations fail in read-only mode

Remove the --readonly flag from your args array in the MCP client configuration, then restart the client. Read-only mode blocks all create, update, and delete tools.

Frequently Asked Questions about ESA MCP

What is ESA MCP?

ESA MCP is a Model Context Protocol (MCP) server that implementation of the model context protocol server that enables ai models to communicate with edge security acceleration (esa) services, allowing models to manage routines, deployments, routes, records, and sites through standardized protocols. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install ESA MCP?

Install via npm with the command: npx -y @koki-develop/esa-mcp-server. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with ESA MCP?

ESA MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is ESA MCP free to use?

Yes, ESA MCP is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Cloud Services MCP Servers

Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "esa-mcp-server": { "command": "npx", "args": ["-y", "@koki-develop/esa-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use ESA MCP?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides