<!-- omit from toc -->
# Wordle MCP (Python)
[](https://codespaces.new/cr2007/mcp-wordle-python)
[](https://deepwiki.com/cr2007/mcp-wordle-python)
> [!NOTE]
> To check out the Go version of this MCP Server (lighter, faster), [click here](https://github.com/cr2007/mcp-wordle-go)
A MCP Server for fetching the Wordle solutions via the Wordle API.
> [!IMPORTANT]
> Wordle solutions are only available from 2021-05-19, to 23 days in the future.<br>
> Any other attempts at calling other dates will return an error from the API
<!-- omit from toc -->
# Index
- [Get Started](#get-started)
- [Using Docker (recommended)](#using-docker-recommended)
- [Installing via `uvx`](#installing-via-uvx)
- [Examples on Claude Desktop](#examples-on-claude-desktop)
- [Contributing](#contributing)
---
# Get Started
## Using Docker (recommended)
Ensure that you have [Docker](https://www.docker.com) installed.<br>
Add this to your MCP Server configuration:
```json
{
"mcpServers": {
"Wordle MCP (Python)": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"--init",
"-e",
"DOCKER_CONTAINER=true",
"ghcr.io/cr2007/mcp-wordle-python:latest"
]
}
}
}
```
> [!IMPORTANT]
> If you get an error on Claude Desktop for the first time, just make sure to pull the image before running.<br>
> `docker pull ghcr.io/cr2007/mcp-wordle-python:latest`
## Installing via `uvx`
The quickest and easiest method to get started. Make sure to install [`uv`](https://docs.astral.sh/uv) before adding this in your configuration.<br>
Add this to your MCP server configuration:
```json
{
"mcpServers": {
"Wordle MCP (Python)":{
"command": "uvx",
"args": [
"--from",
"git+https://github.com/cr2007/mcp-wordle-python",
"mcp-wordle"
]
}
}
}
```
# Examples on Claude Desktop
<div align="center">
<img width=75%, src="./images/Claude_Chat-Example.png">
</div>
# Contributing
Contributions are welcome! You may [fork](https://github.com/cr2007/mcp-wordle-python/fork) the repo, create your changes in a branch, and then create a [Pull Request](https://github.com/cr2007/mcp-wordle-python/compare)
