agh-skos-mcp

MCP server for SkOs — the AGH University staff directory. No API key, no login.

Tools

An ambiguous label raises an error listing the candidates. A query with no filters is rejected.

Related MCP server: CRU MCP Server

Add to Claude Code

Requires uv.

.mcp.json in the project root:

{
  "mcpServers": {
    "agh-skos": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/kbzowski/agh-skos-mcp", "agh-skos-mcp"]
    }
  }
}

Or via CLI:

claude mcp add agh-skos --scope user -- uvx --from git+https://github.com/kbzowski/agh-skos-mcp agh-skos-mcp

Check with claude mcp list or /mcp.

Run over HTTP

The server speaks stdio by default. For a remote setup use the streamable HTTP transport:

agh-skos-mcp --transport streamable-http --host 0.0.0.0 --port 8000

or with Docker, which binds to 127.0.0.1:8000:

docker compose up -d --build
claude mcp add agh-skos --transport http http://127.0.0.1:8000/mcp

There is no authentication. To reach it from outside, put a reverse proxy with TLS in front of it and accept its public name with --allowed-host mcp.example.org (repeatable; see the commented command in compose.yaml). Requests with any other Host header are rejected.

Development

git clone https://github.com/kbzowski/agh-skos-mcp && cd agh-skos-mcp
uv sync

uv run ruff check . && uv run ruff format .
uv run mypy
uv run pytest              # offline
uv run pytest -m network   # against the live directory

uvx caches its build. To run your working copy:

claude mcp add agh-skos --scope user -- uv run --directory /path/to/agh-skos-mcp agh-skos-mcp

Implementation notes

• Data comes from the __NEXT_DATA__ JSON embedded in each rendered page, not from HTML scraping.

• Filter dictionaries come from the site's /a/select?id=… endpoint.

• E-mails are stored obfuscated (reversed <a> tag, # for @) and decoded on the way out.

• A search matching exactly one person redirects /search/ → profile page; search_people follows it and returns the full record in person.

License

MIT