SpecMgr

{
  "name": "io.github.dfch/biz-dfch-specmgr",
  "title": "SpecMgr",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "version": "0.36.0",
  "packages": [
    {
      "version": "0.36.0",
      "transport": {
        "type": "stdio"
      },
      "identifier": "biz-dfch-specmgr",
      "runtimeHint": "uvx",
      "registryType": "pypi",
      "registryBaseUrl": "https://pypi.org",
      "packageArguments": [
        {
          "type": "positional",
          "value": "-m"
        },
        {
          "type": "positional",
          "value": "biz.dfch.specmgr"
        },
        {
          "type": "positional",
          "value": "mcp"
        }
      ],
      "runtimeArguments": [
        {
          "name": "--from",
          "type": "named",
          "value": "biz-dfch-specmgr[mcp]",
          "description": "Install with the 'mcp' extra so the MCP server dependencies (mcp SDK) are available; the base package alone has no MCP support."
        },
        {
          "type": "positional",
          "value": "python"
        }
      ],
      "environmentVariables": [
        {
          "name": "SPECMGR_MCP_TRANSPORT",
          "choices": [
            "stdio",
            "sse",
            "streamable-http"
          ],
          "default": "stdio",
          "description": "Transport mode for the MCP server."
        },
        {
          "name": "SPECMGR_MCP_HOST",
          "default": "localhost",
          "description": "Bind address, SSE/streamable-http mode only."
        },
        {
          "name": "SPECMGR_MCP_PORT",
          "format": "number",
          "default": "8000",
          "description": "TCP port, SSE/streamable-http mode only."
        },
        {
          "name": "SPECMGR_ADR_DIR",
          "format": "filepath",
          "default": "docs/adr",
          "description": "Base directory scanned for Architecture Decision Record (.md) files."
        },
        {
          "name": "SPECMGR_DOCS_DIR",
          "format": "filepath",
          "default": "docs",
          "description": "Shared base directory root for the document-type domains that do not have their own dedicated directory environment variable (req, uc, tsk, qa, prb, gol, rsk, dec, sop, vcr, sysrs). Each domain's own subdirectory is appended automatically, e.g. docs/req."
        },
        {
          "name": "SPECMGR_FEAT_DIR",
          "format": "filepath",
          "default": ".specmgr/feat",
          "description": "Base directory scanned for Feature folders (<base>/<id>/README.md)."
        },
        {
          "name": "SPECMGR_SIMILARITY_DISABLED",
          "description": "Presence-based opt-out for the semantic-similarity search feature (the find_related and find_similar_text tools): set to any value to disable the feature, so that every call returns a structured unavailable result and the embedding model is never loaded, and to skip the similarity phase of the unified server-startup warmup thread. Unset by default. Its resolved state is reported by the similarity section of the specmgr://config resource."
        },
        {
          "name": "SPECMGR_FEAT_WARMUP_DISABLED",
          "description": "Presence-based opt-out for the feat domain's two background cache-warming phases (frontmatter and full-parse) of the unified server-startup warmup thread: set to any value to skip both phases; when set together with SPECMGR_SIMILARITY_DISABLED, no warmup thread is started at all. Unset by default. Its resolved state is reported by the feat_warmup_disabled field of the specmgr://config resource."
        },
        {
          "name": "SPECMGR_PLANTUML_JAR",
          "description": "Path to a plantuml.jar, one of exactly three PlantUML validation-source selectors (the first one set, in JAR then BIN then URL order, is the only source used; no fall-through, no PATH discovery, no public default; all three unset is the offline structure-only floor). Unset by default. The selected source is reported by the plantuml section of the specmgr://config resource."
        },
        {
          "name": "SPECMGR_PLANTUML_BIN",
          "description": "Path to an executable speaking the PlantUML CLI contract, one of exactly three PlantUML validation-source selectors (the first one set, in JAR then BIN then URL order, is the only source used; no fall-through, no PATH discovery, no public default; all three unset is the offline structure-only floor). Unset by default. The selected source is reported by the plantuml section of the specmgr://config resource."
        },
        {
          "name": "SPECMGR_PLANTUML_URL",
          "description": "PlantUML server base URL, one of exactly three PlantUML validation-source selectors (the first one set, in JAR then BIN then URL order, is the only source used; no fall-through, no PATH discovery, no public default; all three unset is the offline structure-only floor). Diagram content is only sent to a PlantUML server if this variable is set. Unset by default. The selected source is reported by the plantuml section of the specmgr://config resource."
        },
        {
          "name": "SPECMGR_DIAGRAM_MAX_TITLE",
          "format": "number",
          "default": "40",
          "description": "Maximum length (in characters) of a resolved node's title label in the reference-graph diagrams (the get_reference_diagram / get_reference_diagram_all MCP tools and the specmgr diagram refs CLI): labels longer than the limit are cut at the last word boundary within the limit (a hard cut when there is none) with an ellipsis appended; the diagram title itself and unresolved node ids are never truncated. An integer; the default 40 applies when the variable is unset or set to an invalid value (empty, non-integer, or less than 1)."
        },
        {
          "name": "SPECMGR_TESTS_NO_DOTENV",
          "description": "Presence-based test/CI sentinel: set to any value to skip the CLI's module-level default .env load entirely, so the process runs under the CI (source-less) condition whatever the local (gitignored) .env configures; this is what keeps the specmgr coverage-badge pre-commit hook's source-less re-run source-less end-to-end. Unset by default, never set outside test runs."
        },
        {
          "name": "FASTEMBED_CACHE_PATH",
          "format": "filepath",
          "default": "<tempdir>/fastembed_cache",
          "description": "Cache directory for the semantic-similarity feature's embedding model (the third-party fastembed backend's own variable, not a SPECMGR_* one): set to a directory to cache the model there; an unset or empty value falls back to the default <tempdir>/fastembed_cache, where <tempdir> is the process's temporary directory (e.g. /tmp on Linux). Unset by default. The resolved directory is reported by the similarity section of the specmgr://config resource."
        }
      ]
    }
  ],
  "repository": {
    "id": "1321701564",
    "url": "https://github.com/dfch/biz.dfch.SpecMgr",
    "source": "github"
  },
  "websiteUrl": "https://github.com/dfch/biz.dfch.SpecMgr#readme",
  "description": "An artifact manager for system specifications."
}