Advertise
MCP.so
Sign In

Gelbooru MCP Server

@citronlegacy

Repository

Basic information

Category

AI & Agents

Transports

stdio

Author

citronlegacy

Submitted by

Citron Legacy

About Gelbooru MCP Server

A Python MCP server that wraps the Gelbooru API. Connect it to any MCP-compatible client (Claude Desktop, Cursor, etc.) to search posts, look up tags, and generate Stable Diffusion prompts from real character appearance data — all directly from your AI assistant.

#anime#mcp#booru#gelbooru#prompt-engineering#stable-diffusion#prompt-generator#mcp-server

Gelbooru MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "gelbooru-mcp": {
      "command": "/absolute/path/to/.venv/bin/python",
      "args": [
        "/absolute/path/to/gelbooru_mcp.py"
      ],
      "env": {
        "GELBOORU_API_KEY": "your_api_key",
        "GELBOORU_USER_ID": "your_user_id"
      }
    }
  }
}

Gelbooru MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Gelbooru Mcp?

A Python MCP server that wraps the Gelbooru API. Connect it to any MCP-compatible client (Claude Desktop, Cursor, etc.) to search posts, look up tags, and generate Stable Diffusion prompts from real character appearance data — all directly from your AI assistant.

How to use Gelbooru Mcp?

Clone the repository, run install.sh (or install mcp manually with pip), then set the optional environment variables GELBOORU_API_KEY and GELBOORU_USER_ID. Start the server with python gelbooru_mcp.py and configure your MCP client (e.g., Claude Desktop) to run the script via the stdio transport.

Key features of Gelbooru Mcp

  • Stable Diffusion Prompt Generation – Build accurate SD prompts from tag frequency data.
  • Appearance Breakdown – Separate eye, hair, and clothing tags with frequency counts.
  • Advanced Post Search – Filter by tags, score, resolution, rating, uploader, and more.
  • Full Tag Syntax – Supports AND, OR, wildcards, exclusion, meta-tags, and sorting.
  • Community Tools – Search users, get post comments, and list deleted posts.
  • Smart Caching – Results cached for 24 hours to avoid repeated API calls.

Use cases of Gelbooru Mcp

  • Generate a Stable Diffusion prompt for a character by analyzing their most-tagged posts.
  • Find high-quality wallpaper images using score, width, and tag filters.
  • Check how many posts a specific tag has and discover related tags.
  • Retrieve comments on a given post or track recently deleted content.

Frequently asked questions

1

Do I need a Gelbooru API key?

API credentials are optional but strongly recommended. Without them, requests are throttled and limited to 2 tags per query. Patreon supporters of Gelbooru receive unlimited requests.

2

What are the runtime requirements?

Python 3.10+ and the `mcp` package. The server uses the stdio transport and does not require a web server.

3

How are Stable Diffusion prompts generated?

The server fetches the most-tagged `rating:general solo` posts for a character, analyzes tag frequency across eye, hair, and other categories, then assembles a ready-to-paste prompt string. Results are cached for 24 hours by default.

4

What tag format does Gelbooru use?

Gelbooru uses `character_(series)` format with underscores (e.g., `misty_(pokemon)`). Always convert natural language names to this format before using the tools. Use `search_tags` with `name_pattern` if unsure.

Comments

More AI & Agents MCP servers

Agent Traffic Lab

Agent Traffic Lab

ATL doesn’t just help agents find tools — it gets the job done. It finds and chooses the right AI provider, tool, or MCP server, executes the task, and switches to a fallback when a provider fails. It can optimize for lo

Heterogent

Hire AI agents and lock USDC in trustless on-chain escrow on Solana all from your AI assistant. Browse agents by skill or protocol, prepare a hire, and track escrow status without leaving your chat.

F

fhirHydrant

faulkj

Open-source Node.js FHIR MCP server with SMART Backend Services, metadata-aware search/CRUD tools, compact responses, FHIRPath filtering, safe pagination, audit events, and terminology lookup.

14
早

早起鸟儿喊真人验真

shenshaoyin

早起鸟儿喊真人验真 is a remote MCP server available at http://121.40.18.232.

HeyLead: LinkedIn Outreach & Lead Generation MCP Server

D4umak

HeyLead: AI agent for LinkedIn outreach. Finds the right people, writes in your voice, follows up and handles replies, from Claude Code, Cursor, any MCP client or a web dashboard.

9
Advertise