tmds-mcp

[!WARNING]
This project is being discontinued in favor of a server-side MCP API.

An MCP server wrapping tmdsclient, exposing read-only TMDS master data to AI assistants (e.g. Claude Desktop) for debugging.

Requires Python 3.11+.

Tools

Installation

pip install tmds-mcp

For use with Claude Desktop or another MCP client, pipx installs the server as a standalone executable:

pipx install tmds-mcp

Configuration

Set environment variables or place them in a .env file in the working directory from which the MCP server is launched:

Usage

Run the server directly:

tmds-mcp

Or add to your MCP client config (e.g. Claude Desktop):

{
  "mcpServers": {
    "tmds": {
      "command": "tmds-mcp",
      "env": {
        "TMDS_URL": "https://techmasterdata.example.de/",
        "TMDS_AUTH_TYPE": "basic",
        "TMDS_USER": "...",
        "TMDS_PASSWORD": "..."
      }
    }
  }
}

Development

This project follows the Hochfrequenz Python template and uses uv for dependency management.

Install the full dev environment with:

uv sync --group dev

Run the individual checks exactly as CI does (each --group pulls in only what it needs):

# tests
PYTHONPATH=src uv run --group tests pytest
# type_check (mypy --strict)
PYTHONPATH=src uv run --group type_check mypy --show-error-codes src/tmds_mcp --strict
PYTHONPATH=src uv run --group type_check mypy --show-error-codes unittests --strict
# linting (ruff)
PYTHONPATH=src uv run --group linting ruff check .
# coverage ≥ 80 %
PYTHONPATH=src uv run --group coverage coverage run -m pytest
PYTHONPATH=src uv run --group coverage coverage report --fail-under 80 --omit "unittests/*"
# formatting (ruff)
uv run --group linting ruff format --check .