PyPI

El proyecto de PyPI arcane-mcp son seis wheels de plataforma, uno por binario de la versión, como distribuyen los suyos ruff y uv: el instalador elige el wheel de tu sistema y pone el binario en la ruta de scripts del entorno como la orden arcane-mcp. Esa orden es el propio binario de la versión, byte a byte; no se ejecuta Python entre tu cliente y el servidor. No se publica nada hasta la primera versión; consulta Instalación.

Requisitos

Python 3.9 o posterior, con uv para uvx (o pipx, o pip).

Wheel	Para
manylinux_2_17_x86_64 / musllinux_1_1_x86_64 (un único wheel), y su gemelo aarch64	Linux en x86-64 o arm64, con glibc o musl (Alpine)
macosx_13_0_x86_64, macosx_13_0_arm64	macOS 13 o posterior, Intel o Apple Silicon
win_amd64, win_arm64	Windows en x64 o arm64

No hay distribución de código fuente: construirla supondría compilar el binario de Go, algo que un instalador de Python no puede hacer.

Ejecutar o instalar

ARCANE_URL=https://arcane.example.com ARCANE_API_KEY=… uvx arcane-mcp

o instálalo una vez, lo que pone una orden arcane-mcp en tu PATH:

uv tool install arcane-mcp     # o: pipx install arcane-mcp
arcane-mcp --version

pip install arcane-mcp en un entorno virtual también funciona, y python -m arcane_mcp ejecuta el mismo binario (el pequeño módulo arcane_mcp del wheel tiene además find_binary(), que devuelve la ruta del binario).

Configurar tu cliente

{
  "mcpServers": {
    "arcane": {
      "command": "uvx",
      "args": ["arcane-mcp==X.Y.Z"],
      "env": {
        "ARCANE_URL": "https://arcane.example.com",
        "ARCANE_API_KEY": "<your Arcane API key>"
      }
    }
  }
}

Tras uv tool install o pipx install, la orden puede ser arcane-mcp, con su ruta absoluta (uv tool dir --bin o pipx environment --value PIPX_BIN_DIR muestran el directorio) si el cliente no ve el PATH de tu shell. La entrada de cada cliente está en Configuración de clientes.

Fijar una versión

Indica la versión, arcane-mcp==X.Y.Z, como hace la entrada de arriba (uv tool install arcane-mcp==X.Y.Z y pipx install arcane-mcp==X.Y.Z para una herramienta instalada). PyPI no tiene etiquetas de distribución: una instalación sin versión toma la más alta, y una versión de mantenimiento anterior nunca desplaza a la más reciente.

Verificarlo

La orden que instala un wheel es el binario de la versión que aparece en el checksums.txt firmado, así que la procedencia de compilación de GitHub para ese artefacto lo verifica:

# uv tool install, pipx o pip: la orden de tu PATH es el binario
gh attestation verify "$(command -v arcane-mcp)" -R jmrplens/arcane-mcp \
  --signer-workflow jmrplens/arcane-mcp/.github/workflows/release.yml

# uvx: el binario está en la caché de uv, y el paquete dice dónde
gh attestation verify "$(uvx --from arcane-mcp python -c 'import arcane_mcp; print(arcane_mcp.find_binary())')" \
  -R jmrplens/arcane-mcp --signer-workflow jmrplens/arcane-mcp/.github/workflows/release.yml

Cada fichero en PyPI lleva además la atestación de publicación del propio PyPI (PEP 740), que se muestra en su página. El resto está en Verificar una versión.

Actualizar y desinstalar

El servidor nunca se actualiza solo.

uv tool upgrade arcane-mcp        # o: pipx upgrade arcane-mcp, pip install -U arcane-mcp
uv tool uninstall arcane-mcp      # o: pipx uninstall arcane-mcp, pip uninstall arcane-mcp

Con uvx, cambia la versión en la entrada del cliente; uv cache clean arcane-mcp elimina las copias en caché.