ESA
- javascript
0
GitHub Stars
javascript
Language
7 months ago
First Indexed
3 months ago
Catalog Refreshed
Documentation & install
Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.
Installation
Add the following to your MCP client configuration file.
Configuration
View docs{
"mcpServers": {
"sou-lab-esa-mcp-server-claude": {
"command": "node",
"args": [
"/path/to/esa-mcp-server-claude/bin/cli.js"
],
"env": {
"PORT": "3000",
"ESA_API_KEY": "YOUR_ESA_API_KEY",
"ESA_TEAM_NAME": "YOUR_TEAM_NAME"
}
}
}
}You can expose ESA.io data as MCP data streams that other MCP clients can consume. This server translates ESA data into MCP format and provides endpoints to fetch data or perform searches, making it easy to integrate ESA content into your MCP-enabled workflows.
How to use
Start the MCP server using the local CLI you installed. Once running, you can connect your MCP client to the server to retrieve ESA data in MCP format or perform searches across ESA data.
Typical usage patterns include starting the server and querying the data endpoint to retrieve current ESA data in MCP format, or sending a search request to filter ESA data by your criteria.
Common MCP client actions you can perform with this server include pulling the full MCP data set and sending a search payload to filter results. Ensure the server port matches the one you configure during startup.
How to install
Prerequisites you need before installation: a working Node.js environment and npm. You will also need access to ESA.io API credentials.
# 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 execute permissions to the CLI (if running directly)
chmod +x bin/cli.js
# Run directly
node bin/cli.js
# Or install globally (from the project root)
npm install -g .
Additional sections
Configuration and startup details are stored on first run. You will be prompted to enter your ESA API key, your ESA team name, and the server port. These values are saved to your home directory at ~/.esa-mcp-server/config.json for subsequent runs.
To start the server after installation, you can use either the installed CLI name or run the CLI script directly. Use the same port you configured during setup unless you change it in the configuration file.
Available tools
getMcpData
Fetches ESA data in MCP format from the server's root or data endpoint.
searchData
Searches ESA data via the /search endpoint to retrieve matching results.
