ergs-mcp

rubiojr/ergs-mcp

3.2

If you are the rightful owner of ergs-mcp 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.

The Ergs MCP Server is a Model Context Protocol server that facilitates interaction with the Ergs API, enabling AI assistants and other MCP clients to search and browse datasources through the Ergs web API.

Ergs MCP Server

A Model Context Protocol (MCP) server that provides tools for interacting with the Ergs API. This server enables AI assistants and other MCP clients to search and browse your datasources through the Ergs web API.

Prerequisites

  1. Ergs: You need to have Ergs installed and configured with your datasources
  2. Ergs Web Server: The Ergs web server must be running (default: http://localhost:8080)
  3. Go: Go 1.21 or later to build the MCP server

Installation

Build from Source

git clone https://github.com/rubiojr/ergs-mcp
cd ergs-mcp
go build -o ergs-mcp

Using Go Install

go install github.com/rubiojr/ergs-mcp@latest

Configuration

The MCP server connects to your Ergs web server. By default, it expects Ergs to be running at http://localhost:8080.

Environment Variables

  • ERGS_URL: The base URL of your Ergs web server (default: http://localhost:8080)

Example

# Use default Ergs URL (localhost:8080)
./ergs-mcp

# Connect to custom Ergs instance
ERGS_URL=http://ergs.example.com:3000 ./ergs-mcp

Usage

Starting the Ergs Web Server

First, make sure your Ergs web server is running:

ergs web --port 8080

Running the MCP Server

Start the MCP server:

./ergs-mcp

The server will communicate via stdio using the MCP protocol.

MCP Client Configuration

Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "ergs": {
      "command": "/path/to/ergs-mcp",
      "env": {
        "ERGS_URL": "http://localhost:8080"
      }
    }
  }
}
Zed Editor

Add to your Zed settings file (~/.config/zed/settings.json on Linux, ~/Library/Application Support/Zed/settings.json on macOS):

{
  "context_servers": {
    "ergs": {
      "command": {
        "path": "/absolute/path/to/ergs-mcp",
        "args": [],
        "env": {
          "ERGS_URL": "http://localhost:8080"
        }
      }
    }
  }
}

Make sure to replace /absolute/path/to/ergs-mcp with the actual path to your built binary.

Other MCP Clients

Configure your MCP client to execute the ergs-mcp binary and communicate via stdio.

Building

go build -o ergs-mcp

Testing

Make sure Ergs web server is running, then test the MCP server:

# Start Ergs web server in one terminal
ergs web --port 8080

# Run the MCP server in another terminal
./ergs-mcp

License

MIT License - see the Ergs project for more details.

Links