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

• Ergs - The main Ergs project
• MCP Go SDK - The Go SDK for Model Context Protocol
• Model Context Protocol - MCP specification