mcp-rule34

An MCP server for rule34.xxx. Search the site's posts by tag through its own API, and get back each post's page, its file, its dimensions, its score, its rating and its full tag list, alongside the number of posts the whole search matches.

This server needs credentials. rule34.xxx issues an API key per account, and its terms allow automated reading through the API alone. Getting one takes a minute and is described under Configuration.

(Version française plus bas / French version below)

Quickstart

Claude Code

claude mcp add rule34 --env RULE34_USER_ID=your-id --env RULE34_API_KEY=your-key -- npx -y mcp-rule34

Claude Desktop, Cursor, and any client using the standard config format

{
  "mcpServers": {
    "rule34": {
      "command": "npx",
      "args": ["-y", "mcp-rule34"],
      "env": {
        "RULE34_USER_ID": "your-id",
        "RULE34_API_KEY": "your-key"
      }
    }
  }
}

With Docker

{
  "mcpServers": {
    "rule34": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "RULE34_USER_ID",
        "-e",
        "RULE34_API_KEY",
        "ghcr.io/smeet666/mcp-rule34:2.0.0"
      ],
      "env": {
        "RULE34_USER_ID": "your-key",
        "RULE34_API_KEY": "your-key"
      }
    }
  }
}

-i keeps stdin open, which is where the protocol travels, and no -t is passed: a TTY rewrites the stream and breaks it. The container needs outbound HTTPS to rule34.xxx and api.rule34.xxx, and nothing else: no volume, no port, and the keys travel through the environment rather than inside the image.

Put this in your user configuration rather than in a project file: a .mcp.json at the root of a repository travels with the repository, and the key travels with it.

Configuration

Where the credentials come from. Sign in, open Account options, and find the row named API Access Credentials. It shows &api_key=…&user_id=…; those two values are what goes in the configuration above. If the key is empty, tick Generate New Key? and save.

The site issues one key per person and asks that applications serving its content display no advertising and put it behind no paywall. This server ships no key

... View full README on GitHub