dss-ai-tools 0.5.1

Command-line client for exploring a Data Shape Server (DSS) knowledge graph schemas

dss-ai-tools

Tools for exploring a Data Shape Server (DSS) knowledge graph schemas — classes, properties, their relations, and namespaces — over the DSS HTTP API. There are three ways to use it, all sharing one small client:

Component	What it is	Where
CLI	A single-file Python client (dss), standard library only. Requires Python >= 3.10.	dss.py
Claude skill	A self-contained Claude Code skill that drives the CLI.	skill/
MCP server	An MCP server exposing the same endpoints as tools.	mcp-server/

The CLI implements the core functionality; the skill and MCP server bundle a copy of dss.py so each is self-contained. Run scripts/sync.sh after editing the canonical dss.py to refresh the copies.

Configure

All three approaches use the same environment variables:

export DSS_BASE_URL=https://dss.semtech.lv   # default
export DSS_TIMEOUT=30                        # optional, seconds

The CLI and MCP tools also accept a per-call override (--base-url / base_url).

CLI

python3 dss.py --help

Install from PyPI to get the dss command on your PATH:

pipx install dss-ai-tools     # provides the `dss` command
# or run without installing:
uvx --from dss-ai-tools dss --help

Or install from a checkout of this repo:

pipx install .          # provides the `dss` command (see pyproject.toml)

Commands

Command	DSS endpoint
ontologies [--variant ...] [--tag TAG]	GET /api/info (variants 2–5, tags; --tag with variant 3)
schema-tags	GET /api/schema_tags
public-ns	GET /api/public_ns
namespaces <ont>	GET /api/ontologies/<ont>/ns
classes <ont> [--limit N] [--filter STR]	POST .../getClasses
properties <ont> [--limit N] [--filter REGEX] [--kind ...]	POST .../getProperties
resolve-class <ont> <name>	POST .../resolveClassByName
resolve-property <ont> <name>	POST .../resolvePropertyByName
class-out-properties <ont> <class_id> [--limit N]	POST .../xx_getClassOutProperties (by c_id)
class-in-properties <ont> <class_id> [--limit N]	POST .../xx_getClassInProperties (by c_id)
class-pairs <ont> <p_list>	POST .../xx_getCPCInfoNew — (source, target) class pairs for a property
call <ont> <fn> [--body JSON|-] [--param k=v ...]	POST .../<fn> (escape hatch)

The class-* commands key on numeric ids: get a class id from resolve-class and a property id from resolve-property.

Output is indented human-readable JSON by default; pass --compact for single-line (pipe-friendly).

dss ontologies | jq '.[].db_schema_name'
dss classes dbpedia --filter Person --limit 20
dss resolve-property dbpedia dbo:birthPlace
dss class-pairs war_sampo 116

Claude skill

skill/ is a self-contained Claude Code skill. Install it user-level:

mkdir -p ~/.claude/skills
cp -R skill ~/.claude/skills/dss

See docs/USAGE.md for setup, pointing it at a server, and example prompts.

MCP server

See mcp-server/README.md. In short, register it from the published package (no checkout needed):

claude mcp add dss -e DSS_BASE_URL=https://dss.semtech.lv -- uvx --from "dss-ai-tools[mcp]" dss-mcp

The mcp extra requires Python >= 3.10. To run from a checkout instead:

cd mcp-server
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
DSS_BASE_URL=https://dss.semtech.lv python3 dss_mcp.py

Exit codes (CLI)

• 0 — success, JSON on stdout
• 2 — HTTP / transport / argument error, message on stderr
• 130 — interrupted (Ctrl-C)

License

MIT