Esa MCP Server Claude

🚀 ESA MCP Server

A server that provides esa.io data in Model Context Protocol (MCP) format. Specifically designed for the Cloud Desktop environment.

🚀 Quick Start

✨ Features

This server offers esa.io data in MCP format, tailored for the Cloud Desktop environment. It provides multiple API endpoints for data retrieval and search.

📦 Installation

# Clone the repository
git clone https://github.com/sou-lab/esa-mcp-server-claude.git
cd esa-mcp-server-claude

# Install dependencies
npm install

# Give execution permission to the CLI
chmod +x bin/cli.js

# Run directly
node bin/cli.js

# Or install globally locally
npm install -g .

💻 Usage Examples

Basic Usage

# If installed
esa-mcp-server

# Or run directly
node bin/cli.js

Advanced Usage

# Example of a search query
curl -X POST http://localhost:3000/search \
  -H "Content-Type: application/json" \
  -d '{"query":"Project A"}'

📚 Documentation

API Endpoints

• GET / - Welcome page
• GET /mcp-data - Retrieve ESA data in MCP format
• POST /search - Search ESA data

Configuration in Claude Desktop

Add the following settings to claude_desktop_config.json in Claude Desktop:

{
  "mcpServers": {
    "esa": {
      "command": "/path/to/node",
      "args": [
        "/path/to/esa-mcp-server-claude/bin/cli.js"
      ],
      "env": {
        "ESA_API_KEY": "Your ESA API Key",
        "ESA_TEAM_NAME": "Your Team Name",
        "PORT": "3000"
      }
    }
  }
}

Explanation of each item:

• command: Path to Node (can be checked with the which node command on Mac/Linux).
• args: Path to the CLI script.
• env: Environment variables (API key, team name, port number).

📄 License

ISC