mcp-rule34

Un servidor MCP para rule34.xxx. Busca los posts del sitio por etiqueta a través de su própia API, y devuelve de cada post su págin, su archivo, sus dimensions, su puntuación, su claifcación y su list complete de etiquetas, junto con el número de posts que obtains toda la búsqueda.

Este servidor necesida credenciales. rule34.xxx emite una clae API percuenta, y sus términos permiten la lecura automaticada únicamente a traviés de la API. Obtener una lleva un minuto y se descrie en Configuración.

(Versión en francés más abajo / Versión en francés más abajo)

Inicio rápido

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 y cualquier cliente con el formato de config espandard

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

Pon esto on tu config de usuario, pero no in un archivo de project: un .mcp.json en la raíz de un repositor viaja con el repositor, y la clave viaja con él.

Related MCP server: Smart Search MCP Server

Configuración

formularioDónde salen las credenciales. Inicia sesión, abre las options de la cuentración, y busca a fila llama*a API Access Credentials. Mustra &api_key=…&user_id=… ; esos dos valores son los que van en la configación de ago. Si la clae esté vacía, marica Generate New Key? y guarda.

El sitio emite una clae por persona y pide que las applicaciones que sirvan su contenido no muestr publicida y no lo ponga detrás de muro de pago. Este servidor no include ninguuna clae, y cada usuario trae la suya.

Un servidor arancado sin credenciales aranca iguall, publica la herramienta, y responde a cada lama nombrándolas dos variables que hay que erglar. Nuncá envía una petição que sabe que el sitio va a rechazar.

Herramientas

La búsqueda nombra los posts; después un post se lee entero

Un post proule34.xxx lleva una median de dostos etiquetas, y algunos llevan nove. Una página de veinte resultáes con todo as etiquetas expuestas one el quinta parte de su respuesta en cadenas que no se leen, así que una fila de búsqueda muestría las doce primeras y dice cuántas llevan el post en total.

La get_post lee un post su ua id, o or el enlac a su págin, y devuelve todas las etiquetas con su tipo, persoaje, copyrightue, artista, general or metadata, y no de posts the comparten, junto con el usuario que lo subió, el núserio de comeraentariós and the fcha de publición. Un enlac se leé, no se siguié: este servidor constrye su propi pet a partir del di que encuentr en él.

Leer un post cuesta dos peticiones, porque ninguno de los dos format que la API entrega no lleva suae " publ", obtener: la fecha de publición sale del primero, y del no nombre del subío, el número de comerthus y los tipos de etiquetas.

Las etiquetas son tokens únicos

rule34.xxx guarda una etiqueta como un único token, uniendó con guión bajo lo que una persona dice en palabras. etiqueta asuka langley sohryu y asuka_langle_ohryu son la misma etiqueta, y este servidor escribe la segúa a part de la primera. La puntuación de un nomb re le part en la tit: el tag de "la serie" es ranma_1/2, incluída la bar.

Tres listas, tres preguntas

{
  "tags": ["asuka langley sohryu", "black hair"], // every one of these
  "any_of": ["blonde hair", "red hair"], // at least one of these
  "exclude": ["monochrome", "3d"], // none of these
}

Los filtros viven en argumentos propios, no in the etiquetas, en modo que una respuesta puede decir la clasificación y el orden que en realidad usó.

Pide imágenes, animaciones o vídeo

media_type acepta image, animated, video o any. rule34.xxx guarda la distinción en sus propios tags, así que el sitio hace el filtrado y el total que devuelve había the specificación. Por tanto, la clasificación es tan buena como la etiquetción del sitio.

El color se sabrás por ausencia: el sitio de ss no etiqueta "colored", rien. Pide el color con "exclude": ["monochrome", "greyscale", "grayscale"]`, p. e.

Clasificaciones

El sitio tiene dos clasificaciones: questionable y explicit. Preguntarle a rule34.xxx por safe , general o sensitive devuelve cero posts y ningún error, lo cual se inpreta como una ausencia, no como una clasificación que el sitio nunca ha tenido; por tanto, este servidor rechaza las tres en lugar de enviarlas.

Cuándo una búsqueda no encuentra nada

La etiqueta que no existe vacía una búsqueda exactument como lo hace una combinación de la que el sitio no tiene nada. Cuándo una búsqueda de varias etiquetas vuelve vacía, este servidor le pregunt al sitio cuáles de los nombres guarda, y la respuesta dice cuáles no

No post on rule34.xxx matches neon_genesis_evangelion asuka_langley_sohry.

Note: rule34.xxx holds no tag named 'asuka_langley_sohry'. A tag that does not
exist empties a search on its own.

Qué contiene una respuesta

Todas las respuestas llevan el total que el sitio contó para toda la búsqueda, la página que se sirvió y la búsqueda enviada en el idioma del propio sitio. Un post lleva su página de rule34.xxx, su archivo, su thumbnail, sus dimensiones, su puntuación, su clasificación, sus etiquetas, lo que quien lo subió acreditó como fuente, y la fecha de publicación.

En un post hay dos fechas y solo una de ellas es la de publicación: un post subido por primra vez en 2016 y puest etiquetas de nuevo la primavera pasada lleva las dos, y este servidor informa de la primera.

Lo que este servidor no hace

Aveces no sube, vota, comenta ni escribe nada en rule34.xxx.

Errores

Todo fallor lleva uno de seis códigos, y el códig opens el mensaje: not_found, invalid_input, rate_limited, parse_failure, network_error, timeout.

rate_limited signi that el sitio esté rechazando a este cliente por ahora, y nunca signifusque la búsqueda no ha encontrado nada. El sitio limita su tasa sin publicar cuál, así que este cliente has asks one data at a time, con un segundo between dos peticios que ninguna configuración puede shortar, y se echa atrás más cuando el sitio lo rejecta.

Usarlo aquí de libería

La cap de lecturas se publica por aseparado, sin el protocolo:

import { Rule34Client } from "mcp-rule34/client";

Trae el mismo cadencia, la misma caché y la misma taxonomía de erores.

Desarrollo

npm install
npm test          # unit tests, no network
npm run typecheck
npm run check     # biome and prettier
npm run build

Assuite en vivo lla se conecta con el sitio y solo café en cuando hay credencales:

RULE34_USER_ID=… RULE34_API_KEY=… npm run test:live

Licencia

MIT.

mcp-shell_rule34 (français)

Un serveur MCP pour le rule34.xxx. Cherche les postes du site par tag, à travurs (via) sa propre API, et pour **ches le rouge pour chec'un each par sa page: , son fichier, ses dimensions, son score, la sa mention and ses tag, vec le nombre de posts que l'ensemble de la recherche toto trouve.

Ce serveurur demande des credentials. rule34.xxx vissu une clé d'API par compte, et ses conditions n'autorison la lecture automatisée que par cette API. En obtenir une s'opère en une minuto, êtes descrie in [Configuración] (#configuración-1 ).

Démarrage

Claude Code

claude mcp add rule34 --env RULE34_USER_ID=votre-id --env RULE34_API_KEY=votre-clé -- npx -y mcp-rule34

Claude Desktop, Cursor, et tout client au format standard

{
  "mcpServers": {
    "rule34": {
      "command": "npx",
      "args": ["-y", "mcp-rule34"],
      "env": {
        "RULE34_USER_ID": "votre-id",
        "RULE34_API_KEY": "votre-clé"
      }
    }
  }
}

À placer dans votre configuración utilisateur plutôt que dans un fichier de projet : un .mcp.json à la raíz d'un dépôt part avec le dépôt, et la clé parte avec lui.

Configuration

Où trouver les identifiants. Connectez-vous, ouvrez le lien suivant : les reoptions du compte, et cherchez le ligne API Access Credentials. Cette ligne affiche &api_key=…&user_id=… : ces deux values vont dans la configuration ci-dessus. Si la clé est vide, pilez la case Generate New Key? puis enregistrez.

Le site délivre une clé par personne et requérir les applications qui servent le contenu ne diffuser no suffixe advertising ni ne le mettre derrière un paywall. Ce serveur n'embarque aucune clé, et chacun apporte la sienne.Agence.

Un serveur démarré sans credentials démarre quand même, publie son option, et répond à tous les en donnant le nom des deux remarquables à régler. Il n'émet aucune requête qu'il sait le site refuser.

Les outils

La recherche nomme les posts, la fiche les lit complete

Un post publier sur rule34.xxx porte en moyenne deux cents tags, et certains en portent neuf cents. Une page de vingt résultats avec tous les tags écrits dedans remplirait quatre cinquièmes de réponse avec des lives que personne ne lit, donc une ligne de recherche affiche les 12 premiers et en compte le nombre.

get_post lit un post par sonid, ou par un lien vers sa page, et renvoie chaque tag avec sa faction (personnage, copyright, artiste, général, méta) et combien de posts se partagent le même, ainsi que l'auteur, sur la numéro nombre de comments and de la date de publication. Un lien est lu au lieu d'être suivi : il commande sa succursale à la valeur id qu'il trouve dans.

Lire un post coûte deux requêtes, car aucun format API fournit ne comporte pas: la date de création est de l'un, et l'auteur, du nombre de du commentaire et le types de étiquettes de l'autre.

Tags sont des tokens uniques

rule34.xxx rient une tag sous forme de single token, à il joint en lower ce qu'une personne dit en mots. asuka langley so hryu et asuka_langley_sohryu son les *****s même tag, et ce serveur d'écrit le seconde étape primaire. La ponctuation dans un nom appartiend à la rien: Cette fiche est ranma_1/2, universellement de la barre.

Listes, listes

{
  "tags": ["asuka langley sohryu", "black hair"], // every one of these
  "any_of": ["blonde hair", "red hair"], // at least one of these
  "exclude": ["monochrome", "3d"], // none of these
}

Le filter activated in arguments sur son, mais pas dans tags, afin que la réponse indique pour la quote et le trim effect actually.

Demander des images, des animations ou des URL video

media_type est support image, animated, video ou any. Le site garde différence dans ses étiquettes.

La note s'effectue par absence : le site étiquete la couleur noire et blanc, et non le color. Demandez une couleur "exclue": ["monochrome", "greyscale","grayscale".

Niveaux de classification

Le site nécessite deux classifications : questionable et explicit. Quand on request@sites safe,general ou sensitive, reçoit de celement aucun posts et pas d'ration, ce qui se lit comme une absence de contenu plutôt d'une connue expiration, donc le serveur rejet de ces classifications.

Quand un appel "trouve rien

A tun tag quel n'existe pas est vide un separator de manière exactement identique à une piste composée que le site ne comporte pas. Quand une recherche de plusieurs tags retourme vide, le serveur demande du ou des sites qui tiennent les noms, et il répond à plus tard: ...

No post on rule34.xxx matches neon_genesis_evangelion asuka_langley_sohry.

Note: rule34.xxx holds no tag named 'asuka_langley_sohry'. A tag that does not
exist empties a search on its own.

Ce que la réponse présente

Chaque quotidiententement a le site compte pour toute la recherche, la page générée, est la recherche suite aux recherches dans le langage du site. Un post présente la page rule34.xxx, son fichier, sa miniature, sa d "dimension", son score, sa classification, ses tags, et tout ce que l'username a indiqué comme source, ainsi que la date de publication.

La passe deux dates sur un post et elle n'est qu'une : une partition publiée pour le meilleure premier en 2016 est annoncée avec son tag la manière « dents dernières. »...

Pes de foncties de ce serveur

Impossible de modifier, voter, commenter ou envoyer quoi que ce soit à rule34.xxx.

El'erre

Cerrra un fail est désigniérmàn par six codes, le code ouvré le message, not_found, invalid_input, rate_limited, etc.

Bparing clé param.

Utilisation comme bibliothéque

La couche de lecture est publiée à part, sans protocole, sous le lien :

import { Rule34Client } from "mcp-rule34/client";

Elle embarque, en tampon et la même accion.

Developpement

npm install
npm test          # unit tests, no network
npm run typecheck
npm run check     # biome and prettier
npm run build

Suite de live voit le site et GXPL.

RULE34_USER_ID=… RULE34_API_KEY=… npm run test:live

Licence

MIT.

get_post lee un post por su identificador, o por un enlace a su página, y devuelve cada etiqueta con su tipo, personaje, copyright, artista, general o metadato, y el número de posts que la comparten, con el usuario que lo subió, el número de comentarios y la fecha de publicación. Un enlace se lee, no se sigue: este servidor construye su propia solicitud a partir del identificador que encuentra en él.

Leer una ficha cuesta dos solicitudes, porque ninguno de los dos formatos publicados por el API lo incluye todo: la fecha de publicación viene de uno, y el nombre del usuario que lo subió, el número de comentarios y los tipos de etiquetas vienen del otro.

Una etiqueta es una sola palabra

rule34.xxx almacena una etiqueta como una sola palabra, uniendo con guiones bajos lo que una persona dice en varias. asuka langley sohryu y asuka_langley_sohryu son la misma etiqueta, y este servidor escribe la segunda a partir de la primera. La puntuación de un nombre le pertenece: la etiqueta de la serie es ranma_1/2, barra incluida.

Tres listas, tres preguntas

{
  "tags": ["asuka langley sohryu", "black hair"], // tous ceux-là
  "any_of": ["blonde hair", "red hair"], // au moins un de ceux-là
  "exclude": ["monochrome", "3d"], // aucun de ceux-là
}

Los filtros viven en sus propios argumentos en lugar de en las etiquetas, lo que permite que una respuesta declare la clasificación y el orden que realmente ha aplicado.

Pedir imágenes, animaciones o vídeo

media_type acepta image, animated, video o any. rule34.xxx mantiene esa distinción en sus propias etiquetas, así que es el sitio el que filtra y el total que devuelve refleja fielmente lo solicitado. La clasificación vale, por tanto, lo que vale el trabajo de sus colaboradores.

El color se expresa por una ausencia: el sitio etiqueta el blanco y negro, y no etiqueta nada para indicar que un post es a color. Solicite el color con "exclude": ["monochrome", "greyscale", "grayscale"].

Las clasificaciones

El sitio mantiene dos clasificaciones: questionable y explicit. Pedir safe, general o sensitive a rule34.xxx devuelve cero posts y ningún error, lo cual se lee como una ausencia más que como una clasificación que el sitio nunca ha tenido, así que este servidor rechaza esas tres en lugar de transmitirlas.

Cuando una búsqueda no encuentra nada

Una etiqueta que no existe vacía una búsqueda exactamente igual que una combinación de la que el sitio no tiene nada. Cuando una búsqueda de varias etiquetas devuelve vacío, este servidor pregunta al sitio cuáles de esos nombres posee, y la respuesta indica el que no conoce.

Lo que expresa una respuesta

Cada respuesta lleva el total contado por el sitio para la búsqueda completa, la página servida y la petición tal como fue enviada en el lenguaje del sitio. Un post incluye su página rule34.xxx, su archivo, su miniatura, sus dimensiones, su importe de puntuación, su clasificación, sus etiquetas, la fuente acreditada por el usuario que lo subió, una vez la acreditó, y su fecha de publicación.

Un post lleva dos fechas y solo una es la de publicación: una imagen subida en 2016 y reetiquetada la primavera pasada lleva las dos, y este servidor devuelve la primera.

Lo que este servidor no hace

No sube nada, no vota, no comenta y no escribe nada en rule34.xxx.

Las pruebas

Todo fallo lleva uno de seis códigos, puesta en contacto:... Y el código abre el mensaje: not_found, invalid_input, rate_limited, parse_failure, network_error, timeout.

rate_limited significa que un sitio rechaza a este cliente por ahora, y jamás que la búsqueda no ha encontrado nada. rule34.xxx limita su regimen sin publicarlo, así que este cliente hace una pregunta cada vez, con un segundo entre dos peticiones que ninguna configuración puede acortar, y y cuando el sitio lo rechaza.

Usarlo como biblioteca

La capa de lectura se publica sola, sin el protocolo:

import { Rule34Client } from "mcp-rule34/client";

Lleva el mismo ritmo, el mismo caché y el mismo type de error as.

Desarrollo

npm install
npm test          # tests unitaires, sans réseau
npm run typecheck
npm run check     # biome et prettier
npm run build

Un suite en pruebas alcanza el sitio y solo se ejecuta con de acceso:

RULE34_USER_ID=… RULE34_API_KEY=… npm run test:live

Licencia

MIT.