Kos

MCP server for the CTU system KOS. (using KOSApi)

Requirements

• Java 21+
• MCP client
• KOS credentials

Building

• Run this command in the project root (output will be in build/libs/)

./gradlew buildFatJar

(You can also get the .jar from releases)

Adding to an MCP Client

To add this server to your MCP client, you need to update your client's configuration file (e.g., mcp_config.json).

{
  "mcpServers": {
    "kos-mcp": {
      "command": "java",
      "args": [
        "-jar",
        "/absolute/path/to/your/file.jar"
      ],
      "env": {
        "KOS_CLIENT_ID": "your_client_id_here",
        "KOS_CLIENT_SECRET": "your_client_secret_here",
        "KOS_TOKEN_URL": "https://auth.fit.cvut.cz/oauth/oauth/token",
        "KOS_SCOPE": "cvut:kosapi:read urn:ctu:oauth:kosapi:public.readonly",
        "KOSAPI_BASE_URL": "https://kosapi.feld.cvut.cz/api/3"
      }
    }
  }
}

Note: If you want data for CTU FIT, change KOSAPI_BASE_URL to https://kosapi.fit.cvut.cz/api/3

How to get the KOS_CLIENT_ID and KOS_CLIENT_SECRET

1. Go to https://auth.fit.cvut.cz/manager/index.xhtml
2. Log in
3. Click "New Project" (you only need to fill in the name)
4. In the project, click "New App"
   • Set the Application Type to "Service Account"
   • Click "Create"
5. Copy your Client ID and Client Secret