Ergs

Provides tools to query and browse Ergs datasources via the Ergs web API.

go

1

GitHub Stars

go

Language

6 months ago

First Indexed

2 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": {
    "rubiojr-ergs-mcp": {
      "command": "./ergs-mcp",
      "args": [],
      "env": {
        "ERGS_URL": "http://localhost:8080"
      }
    }
  }
}

This MCP server provides tools to interact with your Ergs datasources through the Ergs web API. It lets AI assistants and other MCP clients search and browse your data sources, giving you a streamlined way to query and navigate your data ecosystem.

How to use

To use this MCP server, first ensure your Ergs web server is running and reachable at your base URL (default http://localhost:8080). Start the MCP server, then connect your MCP client to the local stdio channel provided by the server.

Typical workflow:

Start your Ergs web server if it isn’t already running. It serves the data sources your MCP server will expose to clients.
Launch the MCP server so it can communicate with Ergs via stdio. The MCP server runs as a local binary you start from your shell.
Configure your MCP client to invoke the ergs-mcp binary via stdio, and point it to the Ergs web API using the ERGS_URL environment variable if you are not using the default URL.

How to install

Prerequisites you need before installation:

Ergs: Install and configure Ergs with your datasources.
Ergs Web Server: Run the Ergs web server (default base URL is http://localhost:8080).
Go: Install Go 1.21 or later to build the MCP server.

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

# Or install the latest release via Go tooling
go install github.com/rubiojr/ergs-mcp@latest

Available tools

search

Search datasources via the Ergs API to quickly locate relevant information.

browse

Browse through available datasources and navigate hierarchical structures exposed by Ergs.