bss-mcp

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

An MCP server wrapping bssclient, exposing read-only BSS investigation-order data to AI assistants (e.g. Claude Desktop) for debugging.

Requires Python 3.11+.

Tools

Installation

pip install bss-mcp

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

pipx install bss-mcp

Configuration

Set environment variables or place them in a .env file in the working directory from which the MCP server is launched (for Claude Desktop this is typically the user's home directory):

Usage

Run the server directly:

bss-mcp

Or add to your MCP client config (e.g. Claude Desktop). Use the full path to the executable if bss-mcp is not on the PATH seen by the client:

{
  "mcpServers": {
    "bss": {
      "command": "bss-mcp",
      "env": {
        "BSS_URL": "https://basicsupply.example.de/",
        "BSS_AUTH_TYPE": "basic",
        "BSS_USER": "...",
        "BSS_PASSWORD": "..."
      }
    }
  }
}

Development

This project follows the Hochfrequenz Python template — see it for general setup instructions (uv, CI, PyPI publishing).

Install the dev dependencies with uv:

uv sync --group dev

Common tasks (the PYTHONPATH=src prefix makes the src layout importable):

PYTHONPATH=src uv run --group tests pytest                                            # run tests
PYTHONPATH=src uv run --group type_check mypy --show-error-codes src/bss_mcp --strict # mypy --strict
PYTHONPATH=src uv run --group linting ruff check .                                    # ruff (lint)
PYTHONPATH=src uv run --group coverage coverage run -m pytest                         # coverage (≥ 80 %)
uv run --group linting ruff format .                                                  # ruff (format)
PYTHONPATH=src uv run --group linting ruff check --select I .                         # ruff (import sort)