Edfringe

An MCP server to interact with the Edinburgh Festivals events and venues

python

1

GitHub Stars

python

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": {
    "richarda23-edfest-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/full/path/to/edfringe-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "api_key": "YOUR_KEY",
        "api_secret": "YOUR_SECRET",
        "GOOGLE_MAPS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can run an MCP server that queries the Edinburgh Festivals API to fetch information about events and venues across Edinburgh’s festivals, including historical data. This enables you to search by location, date, genre, and other criteria, and to get timing information if you have a Google Maps key.

How to use

Once your MCP client is set up, you’ll be able to query events and venues from the Edinburgh Festivals API. You can search for events by location, genre, date, or text, and you can look up venues by festival type or postcode. If you add a Google Maps API key, you can also compute routing and timing between venues.

How to install

Prerequisites: ensure you have Python 3.12+ and uv installed.

Create an Edinburgh Festival API account.
Prepare your environment by creating a .env file in the project root with these variables.

api_secret=your_secret
api_key=your_key
GOOGLE_MAPS_API_KEY=your API key  # optional, enables timing and routing between venues

Install dependencies for the MCP runtime.

uv sync

Add the MCP configuration to your client’s mcp.json as shown.

"edinburghFestival": {
  "command": "uv",
  "args": [
    "--directory",
    "/full/path/to/edfringe-mcp",
    "run",
    "main.py"
  ]
}

Additional notes

If you plan to enable timing and route calculations, include your Google Maps API key in the environment variables listed above.