# MCP Servers Setup Status Tracking the setup and validation of MCP/LSP servers via Docker Compose. Last validated: 2026-01-23 ## Validation Summary **Working MCP Servers:** - ✓ audiobook-mcp: Working (audiobook-library v1.1.0) - requires AUDIOBOOK_ROOT env var - ✓ bitwarden-mcp: Working (Bitwarden MCP Server v2026.1.0) - requires Bitwarden credentials - ✓ blender-mcp: Working (BlenderMCP v1.25.0) - requires Blender with addon running - ✓ cloudron-mcp: Working (cloudron-mcp v0.1.0) - requires CLOUDRON_URL env var - ✓ context7-mcp: Working (Context7 v2.1.0) - stdio-based, requires Upstash Redis - ✓ docker-mcp: Working (docker-mcp v0.1.0) - requires Docker socket mount - ✓ drawio-mcp: Working (drawio-mcp-server v1.4.0) - requires DRAWIO_URL env var - ✓ elasticsearch-mcp: Working (rmcp v0.2.1, deprecated) - requires ES_URL env var - ✓ freecad-mcp: Working (FreeCADMCP v1.25.0) - requires FreeCAD with addon running - ✓ ghost-mcp: Working (ghost-mcp-ts v1.0.0) - requires Ghost CMS credentials - ✓ gimp-mcp: Working (GimpMCP v1.10.1) - requires GIMP with server running - ✗ imap-mcp: Not working - requires working IMAP server (server crashes on startup if IMAP unreachable) **MCP Servers with Configuration Issues:** - ✗ imap-mcp: Not working - requires working IMAP server (server crashes on startup if IMAP unreachable) **Host-Only MCP Servers:** - ✗ kicad-mcp: Requires KiCAD installed on host (pcbnew Python module unavailable in container) **HTTP-based MCP Servers:** - None **Pending Build:** - All other MCP servers pending build **Recently Built:** - audiobook-mcp: Built (v1.1.0) - stdio-based, requires AUDIOBOOK_ROOT - bitwarden-mcp: Built (v2026.1.0) - stdio-based, requires Bitwarden credentials - blender-mcp: Built (v1.25.0) - stdio-based, Python-based, requires Blender with addon - cloudron-mcp: Built (v0.1.0) - stdio-based, requires CLOUDRON_URL - context7-mcp: Built (v2.1.0) - stdio-based, TypeScript-based, requires Upstash Redis - docker-mcp: Built (v0.1.0) - stdio-based, Python-based, requires Docker socket - drawio-mcp: Built (v1.4.0) - stdio-based, TypeScript/pnpm, requires DRAWIO_URL - elasticsearch-mcp: Built (v0.2.1) - stdio-based, Rust-based, requires ES_URL - bash-language-server: Built (v5.6.0) - configured in crush.json via wrapper script - docker-language-server: Built (v0.0.0) - configured in crush.json via wrapper script - marksman: Built (2025-12-13) - configured in crush.json via wrapper script **Builds in Progress:** - None **Build Failures:** - None **Missing Vendor Repositories:** - ✗ matomo-mcp: Cannot build - vendor repo `https://github.com/ahujasid/matomo-mcp-client.git` does not exist (404) **LSP Servers:** - ✓ bash-language-server: Working (v5.6.0) - stdio-based, configured in crush.json - ✓ docker-language-server: Working (v0.0.0) - stdio-based, configured in crush.json - ✓ marksman: Working (2025-12-13) - stdio-based, configured in crush.json ## Detailed Status | Repository | Status | Notes | |------------|--------|-------| | audiobook-mcp | Built | Container built from source (361MB). MCP stdio-based, requires AUDIOBOOK_ROOT env var. Fixed Dockerfile to use npm install instead of npm ci. Version 1.1.0. | | bitwarden-mcp | Built | Container built from source (377MB). Multi-stage distroless build. MCP stdio-based, requires Bitwarden credentials. Version 2026.1.0. | | blender-mcp | Built | Container built from source (321MB). Python-based with uv package manager. MCP stdio-based, requires Blender running with addon. Version 1.25.0. | | cloudron-mcp | Built | Container built from source (374MB). Fixed Dockerfile CMD to use dist/server.js. MCP stdio-based, requires CLOUDRON_URL env var. Version 0.1.0. | | context7-mcp | Built | Container built from source (224MB). Multi-stage Node.js build with tsc. MCP stdio-based, requires UPSTASH_REDIS_REST_URL and TOKEN env vars. Version 2.1.0. | | docker-mcp | Built | Container built from Python source (188MB). Uses uv package manager. MCP stdio-based, requires Docker socket mount (/var/run/docker.sock). Version 0.1.0. | | drawio-mcp | Built | Container built from TypeScript source (302MB). Uses pnpm package manager. MCP stdio-based, requires DRAWIO_URL env var. Version 1.4.0. | | elasticsearch-mcp | Built | Container built from Rust source (22MB). Fixed Dockerfile to pass "stdio" subcommand. MCP stdio-based, requires ES_URL env var. NOTE: Server is deprecated. Version 0.2.1. | | freecad-mcp | Built | Container built from Python source (317MB). Uses uv package manager. MCP stdio-based, requires FreeCAD running with addon. Version 1.25.0. | | ghost-mcp | Built | Container built from TypeScript source (284MB). npm build with tsc. MCP stdio-based, requires Ghost CMS URL and API key. Version 1.0.0. | | gimp-mcp | Built | Container built from Python source (418MB). Uses uv package manager. Fixed Dockerfile to use python -m instead of uvx. MCP stdio-based, requires GIMP with server running. Version 1.10.1. | | imap-mcp | Built | Container built from Python source (317MB). Uses uv package manager. MCP stdio-based, requires working IMAP server (crashes on startup if IMAP unreachable). Version 0.1.0. | | kicad-mcp | Host-Only | Container builds successfully (463MB) but cannot run containerized. Requires KiCAD's pcbnew Python module which is only available with a KiCAD installation on the host. Cannot be pip-installed. Use on host machine only. | | matomo-mcp | Blocked | Cannot build - vendor repository does not exist. CloneVendorRepos.sh references https://github.com/ahujasid/matomo-mcp-client.git which returns 404. | | bash-language-server | Built | Container built using prebuilt npm package (190MB). LSP configured in crush.json via wrapper script. Version 5.6.0. | | docker-language-server | Built | Container built from Go source (49.2MB). LSP configured in crush.json via wrapper script. Version 0.0.0. | | marksman | Built | Container built from prebuilt binary (144MB). LSP configured in crush.json via wrapper script. Version 2025-12-13. | ## Known Issues - matomo-mcp: Vendor repository does not exist. The CloneVendorRepos.sh references `https://github.com/ahujasid/matomo-mcp-client.git` which returns 404. Unable to build until a valid source is identified. ## Usage To build and start a specific server: ```bash docker compose up -d ``` To view logs: ```bash docker compose logs -f ``` To stop a server: ```bash docker compose stop ``` To rebuild a server after changes: ```bash docker compose build --no-cache ``` To test MCP server with Crush: ```bash # Stdio-based servers are run on-demand by Crush # Configuration is in crush.json # Crush automatically handles docker run -i --rm ``` Note: Use lowercase service names from compose file. Container names will be prefixed with kneldevstack-aimiddleware-.