Wordle MCP

Wordle MCP (Python)

[!NOTE] Para ver la versión en Go de este servidor MCP (más ligera y rápida), haz clic aquí

Un servidor MCP para obtener las soluciones de Wordle a través de la API de Wordle.

[!IMPORTANT] Las soluciones de Wordle solo están disponibles desde el 2021-05-19 hasta 23 días en el futuro.
Cualquier otro intento de consultar otras fechas devolverá un error de la API

Índice

• Comenzar
  • Usando Docker (recomendado)
  • Instalación mediante uvx
• Ejemplos en Claude Desktop
• Desarrollo
  • Publicación de versiones
• Contribuciones

---

Comenzar

Usando Docker (recomendado)

Asegúrate de tener Docker instalado.
Añade esto a la configuración de tu servidor MCP:

{
  "mcpServers": {
    "Wordle MCP (Python)": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--init",
        "-e",
        "DOCKER_CONTAINER=true",
        "ghcr.io/cr2007/mcp-wordle-python:latest"
      ]
    }
  }
}

[!IMPORTANT]
Si recibes un error en Claude Desktop la primera vez, asegúrate de extraer la imagen antes de ejecutarlo.
docker pull ghcr.io/cr2007/mcp-wordle-python:latest

Instalación mediante uvx

La forma más rápida y sencilla de comenzar. Asegúrate de instalar uv antes de añadir esto a tu configuración.
Añade esto a la configuración de tu servidor MCP:

{
  "mcpServers": {
    "Wordle MCP (Python)":{
      "command": "uvx",
        "args": [
          "--from",
          "git+https://github.com/cr2007/mcp-wordle-python",
          "mcp-wordle"
        ]
      }
  }
}

Ejemplos en Claude Desktop

Desarrollo

Consulta CONTRIBUTING.md para configurar un entorno de desarrollo y ejecutar la suite de pruebas. Cada push y pull request se valida mediante el flujo de trabajo de CI.

Publicación de versiones

Las versiones se publican mediante el envío de una etiqueta vMAJOR.MINOR.PATCH:

1. Incrementa version en pyproject.toml para que coincida con la nueva versión.
2. Confirma ese cambio.
3. Etiqueta el commit, por ejemplo, git tag v1.2.3 y git push origin v1.2.3.

El flujo de trabajo de publicación rechaza la versión si la etiqueta no coincide con la versión de pyproject.toml, o si fallan las comprobaciones de test/uvx/Docker. En caso de éxito, envía ghcr.io/cr2007/mcp-wordle-python etiquetado con la versión completa, major.minor, major y latest.

Contribuciones

¡Las contribuciones son bienvenidas! Puedes hacer un fork del repositorio, crear tus cambios en una rama y luego crear un Pull Request

Consulta CONTRIBUTING.md para obtener una guía completa sobre cómo configurar un entorno de desarrollo, ejecutar pruebas y las convenciones de commits/PR.