TEDDI Tool

CLI and FastMCP server for the ETSI TEDDI terminology database.

Features

• CLI — teddi search-term / teddi list-bodies with table, JSON, ISON, and TOON output
• MCP server — search_teddi, get_term_info, and list_technical_bodies tools for AI agents
• HTTP caching — hishel/SQLite cache with a two-hour TTL
• Type-safe — Pydantic models and full annotations
• Async-first — one async client shared by both interfaces

Installation

uv tool install teddi-tool      # or: pipx install teddi-tool

From source:

git clone https://github.com/jr2804/teddi-tool.git
cd teddi-tool
mise dev

Usage

teddi search-term "QoS" --pattern exactmatch
teddi search-term "QoS" --scope definitions --output json
teddi search-term "test" --technical-bodies "3gpp,etsi"
teddi list-bodies
teddi-mcp        # MCP server on stdio

teddi-tool and teddi are the same CLI; teddi-cli is an alias kept for existing scripts.

MCP client configuration

{
  "mcpServers": {
    "teddi": {
      "command": "teddi-mcp"
    }
  }
}

Architecture

Development

mise dev        # install tools and sync dev dependencies
mise test       # pytest with coverage
mise all        # test, lint, spell, format, docs

See docs/development.md for setup and release notes. Area contracts live next to the code:

• src/teddi_tool/AGENTS.md — client, parser, CLI/MCP surface
• tests/AGENTS.md — test conventions
• .agents/ONBOARDING.md — entry points and commands

License

MIT