ff-mcp-jira (Python / uv)

The same reliable Jira MCP server as ff-mcp-jira, but no Node.js. One Python file, run by uv. uv downloads its own Python and dependencies on first run — colleagues only need uv installed.

Same 37 jira_* tools, same behavior: Jira Server / Data Center (Bearer PAT) and Atlassian Cloud (Basic + ADF) auto-detected, retries, timeouts, lean fields, full error bodies surfaced to the model.

1. Install uv (one time)

macOS / Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows (PowerShell):

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

2. Get server.py

Copy server.py to a folder you'll keep, e.g. ~/mcp-jira-py/server.py (Windows: C:\Users\you\mcp-jira-py\server.py).

3. Warm the cache once (avoids a client startup timeout)

The very first run downloads Python + deps (~10–20s). Do it once from a terminal so your MCP client doesn't time out on first launch:

uv run --python 3.12 --script /ABSOLUTE/PATH/server.py

It will print Starting ff-mcp-jira and wait — press Ctrl-C, it's working.

4. Configure your MCP client

Claude Desktop config — macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json. (Claude Code: claude mcp add or its config.)

macOS / Linux:

{
  "mcpServers": {
    "jira": {
      "command": "uv",
      "args": ["run", "--python", "3.12", "--script", "/Users/you/mcp-jira-py/server.py"],
      "env": {
        "JIRA_BASE_URL": "https://jira.fintech-farm.com",
        "JIRA_API_TOKEN": "your-personal-access-token"
      }
    }
  }
}

Windows:

{
  "mcpServers": {
    "jira": {
      "command": "uv",
      "args": ["run", "--python", "3.12", "--script", "C:\\Users\\you\\mcp-jira-py\\server.py"],
      "env": {
        "JIRA_BASE_URL": "https://jira.fintech-farm.com",
        "JIRA_API_TOKEN": "your-personal-access-token"
      }
    }
  }
}

If uv isn't found, use its full path (which uv / where uv), e.g. macOS /Users/you/.local/bin/uv, Windows C:\\Users\\you\\.local\\bin\\uv.exe. --python 3.12 makes uv provision a Python even on machines that have none.

Restart the client — the jira_* tools appear in the next conversation. First smoke test: ask it to call jira_get_myself.

Auth

Auto-detected from the hostname. Force with JIRA_AUTH_MODE=basic|bearer.

Self-check

uv run --python 3.12 --script smoke.py

Boots the server offline, asserts all 37 tools register and the ADF/auth/clamp/URL logic is correct. No network calls.