OpenLigaDbLlm

What is OpenLigaDbLlm?

OpenLigaDbLlm is an MCP (Model Context Protocol) Server that exposes tools to query the OpenLigaDb API. It includes a .NET ChatClient demo and a Docker Compose monitoring stack (OpenTelemetry, Loki, Grafana). It is intended for developers building LLM-integrated applications that need live sports league data.

How to use OpenLigaDbLlm?

Clone the repository, set the HELICONE_API_KEY and OPENROUTER_API_KEY environment variables, then start the monitoring stack with docker-compose up -d. Run the McpServer project (dotnet run) first, then the ChatWithTools project in a separate terminal. The ChatClient will connect to the MCP server and allow you to use its tools.

Key features of OpenLigaDbLlm

• Exposes four MCP tools for OpenLigaDb data.
• Includes a demo .NET ChatClient application.
• Built-in monitoring with OpenTelemetry and Helicone.
• Integrates with OpenRouter for LLM API access.
• Uses Docker Compose for easy monitoring stack setup.

Use cases of OpenLigaDbLlm

• Querying available sports leagues via natural language.
• Retrieving teams for a specific league and season.
• Demonstrating MCP server integration with a chat client.
• Monitoring LLM API calls and telemetry in Grafana.

FAQ from OpenLigaDbLlm

What prerequisites are needed to run OpenLigaDbLlm?

Docker and Docker Compose, .NET SDK, and API keys for Helicone and OpenRouter are required.

What tools does the MCP server expose?

The server provides getAvailableLeagues, getFilteredLeagues, getAllTeams, and an echo tool for debugging.

Can I use the MCP server without the included ChatClient?

Yes, the server is a standard MCP server and can be used by any MCP-compatible client.

How is monitoring set up?

The project includes a Docker Compose file for OpenTelemetry Collector, Loki, and Grafana, plus Helicone integration for API call logging.

What data sources does OpenLigaDbLlm use?

It uses the public OpenLigaDb API (openligadb.de) for sports league and team data.