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: krs-verify

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.

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