danbooru-tag-mcp server

danbooru-tag-mcp

A Danbooru tag lookup MCP (Model Context Protocol) server for local AI image generation: your AI client resolves real Danbooru tags — exact names, aliases, categories, post counts, co-occurrence statistics, wiki descriptions, and the tag lists of real posts — before composing prompts, which noticeably improves tag accuracy in generated images.

Quick start

Install per-user (Windows 10/11, no admin rights):

iwr -useb "https://raw.githubusercontent.com/BaixuanZhu/danbooru-tag-mcp/main/install.ps1" | iex

Point your MCP client at the command:

{
  "mcpServers": {
    "danbooru-tags": {
      "command": "danbooru-tag-mcp",
      "args": []
    }
  }
}

That's it — the client picks up the six tools below on its next session.

Features

• 6 MCP tools: tag search, exact tag info, related tags, alias resolution, wiki lookup, and post search
• Tag lists back from post search: search_posts returns each post's full tag list split by category (copyright/artist/character/general/meta), so mining a few posts reveals which tags naturally go together
• Tagger-era tag detection: gettaginfo classifies every name against the pinned WD14 tagger vocabularies (wd14 field: live / taggerera — a tagger-era name Danbooru has since renamed, try gettagalias / unknown), so LoRA card captions stop dead-ending at "tag not found"; searchtags adds wd14_hits fallback hits when no result carries posts
• R-18 by default: search_posts defaults to rating:explicit; pass your own rating:g/s/q/e metatag to narrow a query
• Self-updating: danbooru-tag-mcp upgrade checks GitHub Releases, verifies SHA256 and replaces the binary atomically
• Zero-config install: per-user installer (setup wizard or one-line PowerShell) that registers the install directory into the user PATH automatically
• Polite API usage: requests are throttled to one per 1.5 seconds; anonymous access works, credentials raise the limits (free/anonymous post searches are still capped at 2 content tags per query)

Install

Requires Windows 10/11 on x64 or ARM64.

Option 1: setup wizard (recommended)

Download danbooru-tag-mcp-windows--setup.exe from the latest release and double-click it. This installs per-user to %LOCALAPPDATA%\Programs\danbooru-tag-mcp (no admin rights needed) and registers the user PATH.

Option 2: one-line PowerShell

iwr -useb "https://raw.githubusercontent.com/BaixuanZhu/danbooru-tag-mcp/main/install.ps1" | iex

Custom install directory:

.\install.ps1 -InstallDir "D:\tools\danbooru-tag-mcp"

Option 3: portable zip

Download danbooru-tag-mcp-windows-.zip from the release page, extract danbooru-tag-mcp.exe anywhere, and run it once — the first run silently adds its own directory to the user PATH (idempotent).

Configure your MCP client

Point your MCP client (Claude Desktop, ZCode, etc.) at the command:

{
  "mcpServers": {
    "danbooru-tags": {
      "command": "danbooru-tag-mcp",
      "args": []
    }
  }
}

Shortened. The full README is on GitHub.