Instalación

Requisitos

• macOS, Linux o Windows (amd64 / arm64)
• Go 1.26+ (solo para go install o compilar desde el código fuente)

Compatibilidad

Método	macOS	Linux	Windows
Una línea (curl)	✅	✅	❌
Homebrew	✅	❌	❌
Scoop	❌	❌	✅
APT (deb)	❌	✅	❌
RPM	❌	✅	❌
Docker	✅	✅	✅
GitHub Release	✅	✅	✅
go install	✅	✅	✅
Compilar desde fuente	✅	✅	✅

---

macOS

Una línea (recomendado)

Dos modos de instalación — elija el que mejor se adapte:

# Con sudo (instala en /usr/local/bin — recomendado)
curl -fsSL https://swag2mcp.io/install.sh | bash

# Sin sudo (instala en ~/.local/bin)
curl -fsSL https://swag2mcp.io/install.sh | bash -s -- --local

--sudo (predeterminado): Instala en /usr/local/bin/swag2mcp usando sudo. Se le solicitará su contraseña. Si sudo falla, recurre a ~/.local/bin/swag2mcp.

--local: Instala en ~/.local/bin/swag2mcp sin sudo. Después de la instalación, agregue a su configuración de shell:

export PATH="$HOME/.local/bin:$PATH"

Verificación:

swag2mcp --version

Homebrew

brew install mmadfox/tap/swag2mcp

Verificación:

swag2mcp --version

GitHub Release

1. Abra la página de la última versión
2. Descargue el archivo para su Mac:
   • Apple Silicon: swag2mcp_darwin_arm64.tar.gz
   • Intel: swag2mcp_darwin_amd64.tar.gz
3. Abra la Terminal en la carpeta de descargas y ejecute:

tar -xzf swag2mcp_darwin_*.tar.gz
sudo mv swag2mcp /usr/local/bin/

Verificación:

swag2mcp --version

go install

go install github.com/mmadfox/swag2mcp/cmd/swag2mcp@latest

Asegúrese de que $GOPATH/bin esté en su $PATH:

export PATH=$PATH:$(go env GOPATH)/bin

Verificación:

swag2mcp --version

Compilar desde el código fuente

git clone https://github.com/mmadfox/swag2mcp.git
cd swag2mcp
make build
sudo mv swag2mcp /usr/local/bin/

Verificación:

swag2mcp --version

Docker

Monte ~/.swag2mcp (o su ruta personalizada) en /home/nonroot/.swag2mcp. El entrypoint ajusta automáticamente los permisos de archivos para que el contenedor pueda leer su espacio de trabajo.

Usuarios de Apple Silicon (M1/M2/M3/M4): Agregue --platform linux/amd64 para ejecutar la imagen: docker run --rm --platform linux/amd64 -v ~/.swag2mcp:/home/nonroot/.swag2mcp ...

docker pull ghcr.io/mmadfox/swag2mcp:latest

Ejecutar con transporte stdio:

docker run --rm -i -v ~/.swag2mcp:/home/nonroot/.swag2mcp ghcr.io/mmadfox/swag2mcp:latest mcp

Ejecutar con transporte HTTP:

docker run --rm -p 8080:8080 -v ~/.swag2mcp:/home/nonroot/.swag2mcp ghcr.io/mmadfox/swag2mcp:latest mcp --transport sse --http-addr :8080

Verificación:

docker run --rm -v ~/.swag2mcp:/home/nonroot/.swag2mcp ghcr.io/mmadfox/swag2mcp:latest --version

---

Linux

Una línea (recomendado)

Dos modos de instalación — elija el que mejor se adapte:

# Con sudo (instala en /usr/local/bin — recomendado)
curl -fsSL https://swag2mcp.io/install.sh | bash

# Sin sudo (instala en ~/.local/bin)
curl -fsSL https://swag2mcp.io/install.sh | bash -s -- --local

--sudo (predeterminado): Instala en /usr/local/bin/swag2mcp usando sudo. Se le solicitará su contraseña. Si sudo falla, recurre a ~/.local/bin/swag2mcp.

--local: Instala en ~/.local/bin/swag2mcp sin sudo. Después de la instalación, agregue a su configuración de shell:

export PATH="$HOME/.local/bin:$PATH"

Verificación:

swag2mcp --version

APT (Debian / Ubuntu)

1. Abra la página de la última versión
2. Descargue swag2mcp_linux_amd64.deb
3. Instale:

# Asegúrese de estar en la carpeta de descargas
pwd
sudo dpkg -i swag2mcp_linux_amd64.deb

Verificación:

swag2mcp --version

RPM (Fedora / RHEL)

1. Abra la página de la última versión
2. Descargue swag2mcp_linux_amd64.rpm
3. Instale:

# Asegúrese de estar en la carpeta de descargas
pwd
sudo rpm -i swag2mcp_linux_amd64.rpm

Verificación:

swag2mcp --version

Docker

Monte ~/.swag2mcp (o su ruta personalizada) en /home/nonroot/.swag2mcp. El entrypoint ajusta automáticamente los permisos de archivos para que el contenedor pueda leer su espacio de trabajo.

Usuarios de Apple Silicon (M1/M2/M3/M4): Agregue --platform linux/amd64 para ejecutar la imagen: docker run --rm --platform linux/amd64 -v ~/.swag2mcp:/home/nonroot/.swag2mcp ...

docker pull ghcr.io/mmadfox/swag2mcp:latest

Ejecutar con transporte stdio:

docker run --rm -i -v ~/.swag2mcp:/home/nonroot/.swag2mcp ghcr.io/mmadfox/swag2mcp:latest mcp

Ejecutar con transporte HTTP:

docker run --rm -p 8080:8080 -v ~/.swag2mcp:/home/nonroot/.swag2mcp ghcr.io/mmadfox/swag2mcp:latest mcp --transport sse --http-addr :8080

Verificación:

docker run --rm -v ~/.swag2mcp:/home/nonroot/.swag2mcp ghcr.io/mmadfox/swag2mcp:latest --version

GitHub Release

1. Abra la página de la última versión
2. Descargue el archivo para su arquitectura:
   • amd64: swag2mcp_linux_amd64.tar.gz
   • arm64: swag2mcp_linux_arm64.tar.gz
3. Abra la Terminal en la carpeta de descargas y ejecute:

tar -xzf swag2mcp_linux_*.tar.gz
sudo mv swag2mcp /usr/local/bin/

Verificación:

swag2mcp --version

go install

go install github.com/mmadfox/swag2mcp/cmd/swag2mcp@latest

Asegúrese de que $GOPATH/bin esté en su $PATH:

export PATH=$PATH:$(go env GOPATH)/bin

Verificación:

swag2mcp --version

Compilar desde el código fuente

git clone https://github.com/mmadfox/swag2mcp.git
cd swag2mcp
make build
sudo mv swag2mcp /usr/local/bin/

Verificación:

swag2mcp --version

---

Windows

Scoop

scoop bucket add mmadfox https://github.com/mmadfox/scoop-bucket
scoop install mmadfox/swag2mcp

Verificación:

swag2mcp --version

GitHub Release

1. Abra la página de la última versión
2. Descargue swag2mcp_windows_amd64.zip
3. Extraiga el archivo ZIP (clic derecho → Extraer todo, o con PowerShell)
4. Mueva swag2mcp.exe a C:\Windows\System32\

Verificación:

swag2mcp --version

go install

go install github.com/mmadfox/swag2mcp/cmd/swag2mcp@latest

Verificación:

swag2mcp --version

Compilar desde el código fuente

git clone https://github.com/mmadfox/swag2mcp.git
cd swag2mcp
go build -o swag2mcp.exe ./cmd/swag2mcp

Verificación:

swag2mcp --version

Docker

Monte ~/.swag2mcp (o su ruta personalizada) en /home/nonroot/.swag2mcp. El entrypoint ajusta automáticamente los permisos de archivos para que el contenedor pueda leer su espacio de trabajo.

docker pull ghcr.io/mmadfox/swag2mcp:latest

Run with stdio transport:

docker run --rm -i -v ~/.swag2mcp:/home/nonroot/.swag2mcp ghcr.io/mmadfox/swag2mcp:latest mcp

Run with HTTP transport:

docker run --rm -p 8080:8080 -v ~/.swag2mcp:/home/nonroot/.swag2mcp ghcr.io/mmadfox/swag2mcp:latest mcp --transport sse --http-addr :8080

Verify:

docker run --rm -v ~/.swag2mcp:/home/nonroot/.swag2mcp ghcr.io/mmadfox/swag2mcp:latest --version

---

¿Necesita el servidor mock? Consulte Instalar servidor mock.

Instalar mediante Agente LLM

Si usa un IDE con IA (OpenCode, Cursor, Claude Desktop, VS Code, etc.), consulte Skills para LLM para obtener instrucciones sobre cómo instalar los skills a través de su agente o manualmente.

Algunos IDE y clientes LLM requieren un reinicio después de agregar skills.

---

Verificar

swag2mcp --version

Salida esperada (la versión puede variar):

swag2mcp v*.*.*

---

Próximos Pasos

• Inicio Rápido — póngase en marcha en 2 minutos