uvx plane-mcp-server crashes on startup: ImportError FakeConnection from fakeredis.aioredis

[uwriym]

Bug Description

plane-mcp-server fails to start via uvx plane-mcp-server stdio with an ImportError.

Error

from fakeredis.aioredis import FakeConnection, FakeServer
ImportError: cannot import name 'FakeConnection' from 'fakeredis.aioredis'

Root Cause

The dependency chain plane-mcp-server 0.2.8 → fastmcp 2.14.4 → pydocket 0.16.6 → fakeredis >= 2.32.1 leads to this crash.

pydocket/_redis.py line 63 imports FakeConnection from fakeredis.aioredis, but fakeredis 2.35.0 (the latest version resolved by pip/uv) has removed FakeConnection from that module. Only FakeServer remains. The replacement is FakeAsyncRedisConnection.

Steps to Reproduce

uvx plane-mcp-server stdio

Environment

- plane-mcp-server: 0.2.8
- fastmcp: 2.14.4
- pydocket: 0.16.6
- fakeredis: 2.35.0
- Python: 3.10 / 3.12 (both fail)
- OS: macOS (Apple Silicon)

Workaround

None currently. Downgrading fakeredis is not possible because pydocket >= 0.15.5 requires fakeredis >= 2.32.1.

Suggestion

This likely needs a fix upstream in pydocket (replacing FakeConnection → FakeAsyncRedisConnection), then a version bump in the dependency chain. In the meantime, pinning fakeredis to a version that still exports FakeConnection (if one exists in the >= 2.32.1 range) would be a temporary fix.

[Noah-Everett]

Quick local patch until pydocket fixes the import upstream:

Edit the installed docket/_redis.py (for uv tool installs it's at ~/.local/share/uv/tools/plane-mcp-server/lib/python3.13/site-packages/docket/_redis.py).

Replace line 63:

    from fakeredis.aioredis import FakeConnection, FakeServer

With:

    from fakeredis.aioredis import FakeServer
    try:
        from fakeredis.aioredis import FakeConnection
    except ImportError:
        from fakeredis.aioredis import FakeAsyncRedisConnection as FakeConnection

This handles both old and new fakeredis versions. The patch will be lost on reinstall, but gets plane-mcp-server working again immediately.

[ljnsn]

Another workaround: uvx --with fakeredis<2.35.0 plane-mcp-server stdio

[uwriym]

Confirming @ljnsn 's workaround works. Using uvx --with 'fakeredis<2.35.0' plane-mcp-server stdio resolves the import error.

For those using this via Claude Code / Claude Desktop MCP config, add it to the args in .mcp.json (or claude_desktop_config.json):

{
  "mcpServers": {
    "plane": {
      "command": "uvx",
      "args": ["--with", "fakeredis<2.35.0", "plane-mcp-server", "stdio"],
      "env": {
        "PLANE_API_KEY": "...",
        "PLANE_WORKSPACE_SLUG": "..."
      }
    }
  }
}

Would be great to see this pinned in pydocket or fakeredis version bumped in a patch release.