Ergs MCP

🚀 Ergs MCP Server

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

🚀 Quick Start

The Ergs MCP Server provides a way to interact with the Ergs API. Before using it, ensure you meet the prerequisites and follow the installation steps.

✨ Features

• Enables AI assistants and MCP clients to access datasources through the Ergs web API.
• Supports multiple MCP clients like Claude Desktop and Zed Editor.

📦 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

📚 Documentation

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.

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