mcp

MCP server to enable AI agents to interact with data from kcapp.

Install

Binary

go build -o mcp .

Docker

docker build -t kcapp-mcp .
docker run -e KCAPP_API_URL=http://your-kcapp-host:8001 \
           -e KCAPP_MCP_TRANSPORT=http \
           -p 8080:8080 \
           kcapp-mcp

Docker Compose

See the docker-compose.yaml file

Configuration

Env var	Default	Description
KCAPP_API_URL	http://localhost:8001	URL of the kcapp API
KCAPP_MCP_TRANSPORT	stdio	Transport mode: stdio or http
KCAPP_MCP_PORT	8080	Port to listen on (HTTP transport only)

Claude

Local (stdio)

Add the following to claude_desktop_config.json:

  "mcpServers": {
    "kcapp": {
      "command": "/path/to/mcp",
      "env": { "KCAPP_API_URL": "http://localhost:8001" }
    }
  }

Remote (HTTP)

  "mcpServers": {
    "kcapp": {
      "type": "http",
      "url": "http://your-host:8080/mcp"
    }
  }

Examples

There are tools for getting information about matches, players, statistics, tournaments and more. Once configured the sky is the limit!

---

Player Statistics

Prompt:

Could you give me statistics overview in x01 for Thord

Output:

---

Tournament Statistics

This is data from a real tournament played in kcapp, but with players anonymized for privacy

Prompt:

Could you give me an overview of the Premier League group in the Fall 2024 tournament?

Output: