mcp-rule34

rule34.xxx 用の MCP サーバーです。サイトの投稿をタグで検索し、各投稿のページ、ファイル、寸法、スコア、レーティング、完全なタグリストを、検索全体が一致する投稿数とともに返します。

このサーバーには認証情報が必要です。 rule34.xxx はアカウントごとに API キーを発行し、その利用規約では API 経由での自動読み取りのみが許可されています。取得には1分もかからず、設定 で説明しています。

(Version française plus bas / フランス語版は下)

クイックスタート

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、および標準設定形式を使用するクライアント

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

これはプロジェクトファイルではなく、ユーザー設定に置いてください。リポジトリのルートにある .mcp.json はリポジトリと一緒に移動し、キーも一緒に移動します。

Related MCP server: Smart Search MCP Server

設定

認証情報の入手先。 サインインし、アカウントオプション を開き、API Access Credentials という行を見つけます。そこには &api_key=…&user_id=… と表示されています。その2つの値が上記の設定に入るものです。キーが空の場合は、Generate New Key? にチェックを入れて保存します。

サイトは一人につき1つのキーを発行し、そのコンテンツを提供するアプリケーションは広告を表示せず、ペイウォールの背後に置かないことを求めています。このサーバーは独自のキーを同梱せず、各ユーザーが自分のキーを持ち込みます。

認証情報なしで起動したサーバーも起動し、ツールを公開し、すべての呼び出しに対して設定すべき2つの変数を指定して応答します。サイトが拒否するとわかっているリクエストは送信しません。

ツール

タグの綴り方を見つける

find_tags は rule34.xxx に、テキストの一部で始まる名前と、それぞれが持つ投稿数を尋ねます。名前の先頭から一致するため、kimagure は kimagure_orange_road を見つけますが、名前の途中にある単語は何も見つけません。サイトは最大10個の名前を提供し、回答はその旨を伝えます。10個返ってきた場合は、リストが尽きたのではなく切り詰められたことを意味します。

これは、何も見つからなかった検索がフォールバックするものでもあります。必須タグが存在しない場合、回答はそのタグを指名し、サイトが実際に保持している、そのタグで始まる名前を提供します。

検索は投稿を指名し、投稿は全体として読まれる

rule34.xxx の投稿は中央値で約200個のタグを持ち、中には900個持つものもあります。20件の結果のページで全タグを書き出すと、回答の5分の4を誰も読まないタグ文字列に費やすことになるため、検索行は最初の12個を表示し、投稿が全部でいくつ持っているかを示します。

get_post は、IDまたはページへのリンクで1つの投稿を読み取り、すべてのタグをその種類（キャラクター、著作権、アーティスト、一般、メタデータ）と、そのタグを共有する投稿数とともに返します。さらに、アップロード者、コメント数、サイトが受け付けた日付も返します。リンクはフォローされるのではなく読み取られます。このサーバーは、リンク内で見つけたIDから独自のリクエストを構築します。

1つの投稿を読むには2回のリクエストが必要です。APIが公開する形式のどちらもすべてを保持していないためです。サイトが投稿を受け付けた日付は一方から、アップロード者の名前、コメント数、タグの種類はもう一方から取得します。

タグは単一のトークン

rule34.xxx はタグを1つのトークンとして保存し、人が言葉で言うものをアンダースコアで結合します。asuka langley sohryu と asuka_langley_sohryu は同じタグであり、このサーバーは前者から後者を生成します。名前内の句読点はその名前に属します。シリーズタグは ranma_1/2 で、スラッシュも含みます。

3つのリスト、3つの質問

{
  "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
}

フィルターはタグ内ではなく独自の引数に存在するため、回答は実際に使用したレーティングと並び順を明示できます。

画像、アニメーション、動画を要求する

media_type は image、animated、video、any を受け取ります。rule34.xxx はその区別を独自のタグで保持しているため、サイトがフィルタリングを行い、返される合計は要求されたものを数えます。したがって、分類はサイトのタグ付けと同じくらい正確です。

色は不在によって示されます。サイトは白黒のものをタグ付けし、カラーであることを示すタグは付けません。カラーを要求するには、"exclude": ["monochrome", "greyscale", "grayscale"] を使用します。

レーティング

サイトには questionable と explicit の2つのレーティングがあります。rule34.xxx に safe、general、sensitive を要求すると、0件の投稿とエラーなしが返ります。これはサイトが持っていないレーティングとしてではなく、不在として解釈されるため、このサーバーはこれら3つを渡さずに拒否します。

検索が何も見つからない場合

存在しないタグは、サイトが何も持っていない組み合わせと同じように検索を空にします。複数のタグの検索が空で返ってきた場合、このサーバーはサイトにどの名前を保持しているかを尋ね、回答はどの名前を保持していないかを示します：

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.

回答が示すもの

すべての回答には、サイトが検索全体で数えた合計、提供されたページ、およびサイト自身の言語で送信された検索が含まれます。投稿には、rule34.xxx のページ、ファイル、サムネイル、寸法、スコア、レーティング、タグ、アップローダーがソースとしてクレジットしたもの、そして rule34.xxx が受け付けた日付が含まれます。

投稿には2つの日付があり、どちらもその主題が作られた日ではありません。1つ目はサイトが投稿を受け付けた日、2つ目は投稿が最後に変更された日で、タグの付け直しによって変わります。rule34.xxx は古いカタログの多くを一括でインポートしたため、何千もの投稿が2010年11月のある1日を共有しています。何が最初に来たかという質問には、作品ではなくインポートが答えになります。

このサーバーが行わないこと

rule34.xxx にアップロード、投票、コメント、書き込みを一切行いません。

エラー

すべての失敗には6つのコードのいずれかが含まれ、コードがメッセージの先頭に付きます：not_found、invalid_input、rate_limited、parse_failure、network_error、timeout。

rate_limited は、サイトが現在このクライアントを拒否していることを意味し、検索が何も見つからなかったことを意味するものではありません。rule34.xxx はレートを公開せずに制限しているため、このクライアントは一度に1つの質問をし、2つのリクエストの間に1秒の間隔を置きます。これは設定で短縮できません。また、サイトが拒否した場合はさらに間隔を空けます。

ライブラリとして使用する

読み取りレイヤーはプロトコルなしで単独で公開されています：

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

同じペーシング、同じキャッシュ、同じエラー分類を持ちます。

開発

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

ライブスイートはサイトに到達し、認証情報が存在する場合にのみ実行されます：

RULE34_USER_ID=… RULE34_API_KEY=… npm run test:live

ライセンス

MIT。

mcp-rule34 (français)

Un serveur MCP pour rule34.xxx. Cherche les posts du site par tag, à travers sa propre API, et rend pour chacun sa page, son fichier, ses dimensions, son score, sa classification et ses tags, avec le nombre de posts que la recherche entière trouve.

Ce serveur demande des identifiants. rule34.xxx délivre une clé d'API par compte, et ses conditions n'autorisent la lecture automatisée que par cette API. En obtenir une prend une minute, voir Configuration.

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 configuration utilisateur plutôt que dans un fichier de projet : un .mcp.json à la racine d'un dépôt part avec le dépôt, et la clé part avec lui.

Configuration

Où trouver les identifiants. Connectez-vous, ouvrez les options du compte, et cherchez la ligne API Access Credentials. Elle affiche &api_key=…&user_id=… : ces deux valeurs vont dans la configuration ci-dessus. Si la clé est vide, cochez Generate New Key? puis enregistrez.

Le site délivre une clé par personne et demande qu'une application servant son contenu n'affiche aucune publicité et ne le mette derrière aucun péage. Ce serveur n'embarque aucune clé, et chacun apporte la sienne.

Un serveur démarré sans identifiants démarre quand même, publie son outil, et répond à chaque appel en nommant les deux variables à régler. Il n'émet jamais une requête dont il sait que le site la refusera.

Les outils

タグの表記を見つける

find_tags は rule34.xxx に、あるテキストで始まる名前と、それぞれが何件の投稿を持つかを尋ねます。照合は名前の先頭から行われるため、kimagure は kimagure_orange_road を見つけますが、名前の途中にある単語は何も見つけません。サイトは最大10個の名前を提示し、応答はそれを示します。10件返ってきた場合は、リストが尽きたのではなく切り詰められたことを意味します。

これはまた、何も見つからなかった検索のフォールバックでもあります。必須タグが存在しない場合、応答はそのタグを指名し、サイトが保持している同じ接頭辞で始まる名前を提案します。

検索は投稿を列挙し、詳細は完全に読み込む

rule34.xxx の投稿は中央値で約200個のタグを持ち、中には900個持つものもあります。全タグを書き出した20件の結果ページは、応答の5分の4を誰も読まない文字列に費やすことになるため、検索行は最初の12個を表示し、投稿が合計で何個のタグを持つかを示します。

get_post は投稿をIDまたはページへのリンクで読み、各タグをそのタイプ（キャラクター、著作権、アーティスト、一般、メタデータ）と、それを共有する投稿数とともに返します。さらに投稿者、コメント数、サイトが投稿を取得した日付も返します。リンクは読み取られ、追跡されません。このサーバーはリンク内のIDから独自のリクエストを構築します。

詳細を読むには2回のリクエストが必要です。APIが公開する2つの形式のどちらもすべてを保持していないためです。サイトが投稿を取得した日付は一方から、投稿者名、コメント数、タグタイプはもう一方から取得します。

タグは1つの単語

rule34.xxx はタグを1つの単語にまとめ、人が複数の単語で言うものをアンダースコアで結合します。asuka langley sohryu と asuka_langley_sohryu は同じタグであり、このサーバーは前者から後者を生成します。名前の句読点はその名前の一部です。シリーズのタグは ranma_1/2 で、スラッシュも含みます。

3つのリスト、3つの質問

{
  "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à
}

フィルターはタグではなく独自の引数に存在し、応答が実際に適用した分類と並び順を明示できるようにします。

画像、アニメーション、または動画を要求する

media_type は image、animated、video、any を受け入れます。rule34.xxx はその区別を独自のタグに持っているため、フィルタリングはサイトが行い、返される合計は要求された内容を正確に反映します。したがって、分類は貢献者の作業の質に依存します。

色は不在によって表現されます。サイトは白黒をタグ付けし、カラーの投稿には何もタグ付けしません。色を要求するには "exclude": ["monochrome", "greyscale", "grayscale"] を使用します。

分類

サイトは2つの分類を保持しています：questionable と explicit。rule34.xxx に safe、general、sensitive を要求すると、0件の投稿とエラーなしが返ります。これはサイトが持ったことのない分類としてではなく、不在として読まれます。そのため、このサーバーはこれら3つを送信せずに拒否します。

検索が何も見つからないとき

存在しないタグは、サイトが何も持っていない組み合わせとまったく同じように検索を空にします。複数タグの検索が空で返った場合、このサーバーはサイトにこれらの名前のどれを保持しているかを尋ね、応答はサイトが知らないものを示します。

応答が示す内容

各応答は、サイトが検索全体に対して数えた合計、提供されたページ、およびサイトの言語で送信されたクエリを保持します。投稿は、rule34.xxx のページ、ファイル、サムネイル、寸法、スコア、分類、タグ、投稿者がクレジットした場合のソース、および rule34.xxx が投稿を取得した日付を保持します。

投稿は2つの日付を持ち、どちらもその主題が作られた日付ではありません。1つ目はサイトが投稿を取得した日、2つ目は最後に変更された日で、再タグ付けによって移動します。rule34.xxx は古いコレクションの大部分を一括インポートしたため、何千もの投稿が2010年11月の同じ日付を持っています。何が最初に来るかという質問には、作品ではなくインポートが答えます。

このサーバーが行わないこと

アップロードは行わず、投票もコメントもせず、rule34.xxx に何も書き込みません。

エラー

すべての障害は6つのコードのいずれかを保持し、コードがメッセージを開きます：not_found、invalid_input、rate_limited、parse_failure、network_error、timeout。

rate_limited は、サイトが当面このクライアントを拒否していることを意味し、検索が何も見つからなかったことを意味することは決してありません。rule34.xxx はレート制限を公開せずに実施しているため、このクライアントは一度に1つの質問を行い、2つのリクエストの間に1秒の間隔を置きます。これはどの設定でも短縮できず、サイトに拒否されるとさらに間隔を広げます。

ライブラリとして使用する

読み取り層はプロトコルなしで単独で公開されています：

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

同じレート、同じキャッシュ、同じエラータクソノミーを保持しています。

開発

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

ライブスイートはサイトに到達し、認証情報がある場合にのみ実行されます：

RULE34_USER_ID=… RULE34_API_KEY=… npm run test:live

ライセンス

MIT。