cr2007/mcp-wordle-go

Wordle MCP - Go

A MCP Server implemented in Go for fetching the Wordle solutions via the Wordle API.

[!NOTE] Wordle solutions are only available from 2021-05-19, to 23 days in the future.
Any other attempts at calling other dates will return an error from the API

Index

• Get Started
  • Using Docker (recommended)
  • Local Setup
    • Setup
• Examples on Claude Desktop
• Contributing

Get Started

Using Docker (recommended)

The quickest and easiest method to get started. Ensure that you have Docker installed.
Add this to your MCP Server configuration:

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

[!IMPORTANT]
If you get an error on Claude Desktop for the first time, just make sure to pull the image before running.
docker pull ghcr.io/cr2007/mcp-wordle-go:latest

Local Setup

For this setup, you need to make sure that you have the Go programming language installed on your machine.

Setup

Before adding this to your MCP Server, you need to do the following:

# Clone the Git repository
git clone https://github.com/cr2007/mcp-wordle-go
cd mcp-wordle-go

# Install the dependencies
go mod tidy

# Build the executable
go build main.go

Add this to your MCP server configuration:

{
  "mcpServers": {
    "Wordle-MCP-Go":{   
        "command": "ABSOLUTE//PATH//TO//THE/EXECUTABLE//FILE",
      }
  }
}

Examples on Claude Desktop

Contributing

Contributions are welcome! You may fork the repo, create your changes in a branch, and then create a Pull Request