ksp-mods-mcp

MCP server for searching KSP mods from the CKAN index.

Installation

Requires uv.

uv tool install git+https://github.com/tabbykat113/ksp-mods-mcp

That's it. The index is built automatically on the first tool call.

The database is stored in your platform's data directory (~/.local/share/ksp-mods-mcp/ckan.db on Linux, AppData/Local/ksp-mods-mcp/ckan.db on Windows). Override with the CKAN_DB environment variable if needed.

You can also run harvest manually at any time to update the index — it's a no-op if nothing changed upstream.

Related MCP server: mcp-server-npm

Adding to your MCP client

Claude Desktop

Edit claude_desktop_config.json (find it via Settings → Developer):

{
  "mcpServers": {
    "ckan": {
      "command": "ksp-mods-mcp"
    }
  }
}

Other MCP clients

Use ksp-mods-mcp as the command. The server communicates over stdio.

Tools

Search options

• name — regex matched against identifier and display name, e.g. "engineer", "^MechJeb", "visual|scatter"

• author — regex matched against author(s), e.g. "sarbian", "squad|nertea"

• tags + tags_mode — "and" (all tags required) or "or" (any tag)

• ksp_versions — e.g. ["1.12"]; matches any mod with a release supporting that version

• sort_by — "downloads" (default), "downloads asc", "name", "name desc", "download_size", "install_size", "updated", "updated asc"

• cached_only — only return mods whose latest-version ZIP is present in the CKAN download cache

• limit / offset — pagination (max 100 per page)

Recommendations options

• identifiers — list of CKAN mod identifiers to find relations for

• categories — which relationship types to include (default: depends, recommends, suggests):

  • Forward: depends, supports, recommends, suggests

  • Reverse: depends_by, supported_by, recommended_by, suggested_by

  • Pass ["all"] to include all categories

• Results are deduplicated: if the same mod appears via multiple sources or categories, the highest-priority category wins and all source mods are listed in related_mods

• limit / offset — pagination (max 100 per page)

CKAN download cache integration

If CKAN is installed and has downloaded mods, is_cached: true appears on any result whose latest-version ZIP is present in the local download cache. The cache directory is detected automatically (%LOCALAPPDATA%/CKAN/downloads on Windows, $XDG_DATA_HOME/CKAN/downloads on Linux). Override with the CKAN_DOWNLOAD_CACHE environment variable.

Note: is_cached reflects the latest version of a mod. If you have an older version cached but not the latest, the flag will not appear — the cached copy may not match what CKAN would install. If you're pinned to an older KSP version (e.g. 1.8.1) and intentionally keep older mod versions, use the ksp_versions filter to find compatible mods and disregard the cached status.

Both list_parts_tool and get_part_tool require a cached ZIP to work.

Part detail levels

list_parts_tool has three detail levels:

• summary — total part count and category breakdown

• basic — per-part name, resolved title, and category

• long — basic + cost, mass, tech node, bulkhead profiles, supported module type names, unsupported module names, and carried resource names

get_part_tool always returns full detail: all of the above plus structured module data (engine thrust, Isp, propellants; RCS thrust and propellants; reaction wheel torque; solar panel output; command pod crew; parachute drag; decoupler ejection force; docking node type; generator and converter rates; harvester efficiency) and full resource amounts. Module types with no formatter are listed by name under unsupported_modules.

Development

git clone https://github.com/tabbykat113/ksp-mods-mcp
cd ksp-mods-mcp
uv sync
uv run harvest
uv run ksp-mods-mcp