ZeroChan MCP

MCPAI代理

提供方 citronlegacy

AI代理 未标注 无需鉴权 社区 / 第三方

MCP server for the Zerochan anime image board API. Browse the global feed, search by tags, and retrieve full entry metadata — directly from any MCP-compatible AI assistant.

一句话选型结论

按资料字段整理

ZeroChan MCP 属于AI代理类 MCP 服务器,传输方式未标注,无需鉴权,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权无需鉴权 部署方式支持远程部署
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
ZeroChan MCP当前 未标注 未标注 支持远程部署 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方citronlegacy上游标注的维护方 citronlegacy
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型支持远程部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

11.8 KB
来自项目仓库与上游目录的原文,未做删改

zerochan-mcp

A Python MCP server wrapping the read-only Zerochan anime image board API. Connect it to Claude Desktop, Cursor, or any MCP-compatible AI assistant to browse, search, and inspect one of the web's most comprehensively tagged anime image collections — directly from a conversation.

Built as a sister server to gelbooru-mcp.


✨ Features

  • Browse the global Zerochan feed — sort by newest or most-favorited, filter by dimensions or dominant color
  • Search by one or more tags simultaneously using Zerochan's natural Title Case format (Hatsune Miku, not hatsune_miku)
  • Strict mode — narrow results to entries where a specific tag is the primary subject, cutting group shots and incidental appearances
  • Full entry details — all tags, full/medium/small image URLs, source, dimensions, favorites, and anime/manga/game associations
  • Returns results as a clean Markdown table or raw JSON — your choice
  • Fully Pydantic-validated inputs with enum constraints and custom tag validators
  • Clear, actionable error messages for rate limits, auth failures, and timeouts

📦 Installation

Prerequisites

  • Python 3.10+
  • git

Quick Start```bash

git clone https://github.com/citronlegacy/zerochan-mcp.git
cd zerochan-mcp
chmod +x setup.sh && ./setup.sh


Or without chmod:```bash
bash setup.sh

Manual Install```bash

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt


---

## 🔑 Authentication

Zerochan requires a valid **username** in every request's User-Agent header. Unauthenticated requests are blocked.```bash
export ZEROCHAN_USERNAME="YourZerochanUsername"

> Your username is included in the User-Agent string as zerochan-mcp - YourUsername, exactly as Zerochan's API requires. The server validates this on every call and returns a clear error message if it is missing — no silent failures.


▶️ Running the Server```bash

via the venv created by setup.sh:

.venv/bin/python server.py

or with the venv activated:

source .venv/bin/activate
python server.py


---

## ⚙️ Configuration

### Claude Desktop

Add the following to your `claude_desktop_config.json`:```json
{
  "mcpServers": {
    "zerochan-mcp": {
      "command": "/absolute/path/to/zerochan-mcp/.venv/bin/python",
      "args": ["/absolute/path/to/zerochan-mcp/server.py"],
      "env": {
        "ZEROCHAN_USERNAME": "YourZerochanUsername"
      }
    }
  }
}

VS Code / Cursor / Other MCP Clients

Configure according to your client's documentation:

  • Command: /absolute/path/to/zerochan-mcp/.venv/bin/python
  • Args: /absolute/path/to/zerochan-mcp/server.py
  • Transport: stdio
  • Env: ZEROCHAN_USERNAME=YourZerochanUsername

Test with MCP Inspector```bash

npx @modelcontextprotocol/inspector .venv/bin/python server.py


---

## 💡 Usage Examples

### Browse the latest anime art

> "Show me the 10 most recent images on Zerochan."

The LLM calls `zerochan_browse` with `limit: 10, sort: "id"` and returns a paginated Markdown table of the newest uploads — IDs, tags, dimensions, and direct links.

---

### Find the all-time most favorited images

> "What are the most popular images on Zerochan of all time?"

The LLM calls `zerochan_browse` with `sort: "fav", time_range: "0"` and returns the highest-favorited entries globally.

---

### Search for a character

> "Find me portrait-mode images of Hatsune Miku."

The LLM calls `zerochan_search` with `tags: ["Hatsune Miku"], dimensions: "portrait"`. No tag normalization required — Zerochan's Title Case maps almost one-to-one with how people naturally write character names.

---

### Multi-tag search — character + theme

> "Show me Rem from Re:Zero with an umbrella."

The LLM calls `zerochan_search` with `tags: ["Rem", "Umbrella"]`. Zerochan joins them as `/Rem,Umbrella?json` internally, returning only images tagged with **both** simultaneously.

---

### Strict mode — images where a character is the main subject

> "I only want images where Hatsune Miku is the actual primary subject, not just tagged."

The LLM calls `zerochan_search` with `tags: ["Hatsune Miku"], strict: true`. This filters to entries where Hatsune Miku is the **primary tag**, removing group shots and background appearances.

---

### Get full metadata for a specific post

> "Give me all the details on Zerochan entry 3793685 — tags, source, full image URL."

The LLM calls `zerochan_get_entry` with `entry_id: 3793685` and returns a complete metadata card: every tag, full/medium/small image URLs, source, dimensions, favorites, and associated anime/game/manga categories.

---

### Raw JSON for downstream processing

> "Search for Yotsuba images and give me the raw JSON."

The LLM calls `zerochan_search` with `tags: ["Yotsuba"], response_format: "json"` and returns the unprocessed Zerochan API payload ready for further processing.

---

## 🛠️ Available Tools

| Tool | Description | Key Parameters |
|---|---|---|
| `zerochan_browse` | Browse the global Zerochan feed | `page`, `limit`, `sort`, `time_range`, `dimensions`, `color` |
| `zerochan_search` | Search entries by one or more tags | `tags`, `strict`, `page`, `limit`, `sort`, `dimensions`, `color` |
| `zerochan_get_entry` | Get full metadata for a single entry by ID | `entry_id` |

All tools accept `response_format: "markdown"` (default) or `"json"`.

---

## 📖 Tools Reference

### `zerochan_browse`

Browse all Zerochan entries with optional filtering and pagination. No tag required — queries the full global feed.

**Parameters**

| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| `page` | int | ❌ | 1 | Page number (starts at 1) |
| `limit` | int | ❌ | 20 | Results per page (1–250) |
| `sort` | enum | ❌ | `id` | `id` = newest first, `fav` = most favorited |
| `time_range` | enum | ❌ | — | `0` = all time, `1` = last 7 000 entries, `2` = last 15 000 entries |
| `dimensions` | enum | ❌ | — | `large`, `huge`, `landscape`, `portrait`, `square` |
| `color` | str | ❌ | — | Dominant color name, e.g. `blue`, `red`, `pink` |
| `response_format` | enum | ❌ | `markdown` | `markdown` or `json` |

**Example response**```
### Zerochan Results from `Global Feed`

| ID | Tags | Dimensions | Favorites | Full Image |
|---|---|---|---|---|
| 4666171 | Female, Twin Tails, Flower, Hatsune Miku, Music (+33 more) | 1000×1500 | ? | View |

zerochan_search

Search Zerochan entries by one or more tags. Tags use Zerochan's Title Case with spaces format.

Parameters

Parameter Type Required Default Description
tags list[str] ✅ — One or more tags, e.g. ["Hatsune Miku"] or ["Rem", "Umbrella"]
strict bool ❌ false Restrict to entries where the first tag is the primary tag (single-tag only)
page int ❌ 1 Page number
limit int ❌ 20 Results per page (1–250)
sort enum ❌ id id = newest, fav = most favorited
dimensions enum ❌ — large, huge, landscape, portrait, square
color str ❌ — Dominant color filter
response_format enum ❌ markdown markdown or json

> Tag format: Zerochan uses Title Case with spaces — Hatsune Miku not hatsune_miku. Natural-language character names work verbatim in most cases.

> Multi-tag: tags: ["Hatsune Miku", "Flower"] → /Hatsune+Miku,Flower?json

> Strict mode: Only works with a single tag. Silently ignored when multiple tags are provided.


zerochan_get_entry

Retrieve complete metadata for a single Zerochan post by its numeric ID.

Parameters

Parameter Type Required Default Description
entry_id int ✅ — Numeric post ID, e.g. 3793685 (visible in the post URL)
response_format enum ❌ markdown markdown or json

Example response (markdown)```

Zerochan Entry #3793685

Primary Tag: Hatsune Miku
Dimensions: 1748 × 2480
Favorites: 42
Source: https://...
Tags (28): Hatsune Miku, VOCALOID, Female, Twin Tails, ...

Full Image: https://static.zerochan.net/...
Medium Preview: https://static.zerochan.net/...


**Response schema (JSON)**```json
{
  "id": 3793685,
  "primary": "Hatsune Miku",
  "tags": ["Hatsune Miku", "VOCALOID", "Female", "..."],
  "width": 1748,
  "height": 2480,
  "fav": 42,
  "source": "https://...",
  "full": "https://static.zerochan.net/...",
  "medium": "https://static.zerochan.net/...",
  "small": "https://static.zerochan.net/...",
  "anime": "VOCALOID",
  "manga": null,
  "game": null
}

🤖 Notes for LLMs

  • Tag format: Zerochan uses Title Case with spaces — Hatsune Miku, Rem, Attack On Titan. Unlike Gelbooru/Danbooru, natural-language names map directly to Zerochan tags in most cases.
  • Strict mode: Use it when the user asks specifically for images of a character, not just images featuring them. Only valid with a single tag.
  • Multi-tag search: Each entry must match all tags. Use for character + theme combos (["Rem", "Rain"], ["Naruto", "Ramen"]).
  • Pagination: zerochan_browse and zerochan_search return up to 250 results per call. Use page to paginate through up to 100 pages (20 000 entries) per tag.
  • Rate limit: 60 requests/minute. Avoid tight loops; space calls when paginating deeply.
  • Entry IDs: Visible in Zerochan URLs (zerochan.net/3793685). Pass them to zerochan_get_entry to resolve full metadata.

⚠️ Known Limitations

  • Rate limit: 60 requests/minute enforced server-side. Exceeding this may trigger a temporary ban.
  • Username required: Every request must carry a valid Zerochan username in the User-Agent. The server validates this and returns a clear error if missing.
  • Strict mode + multi-tag: Strict mode is silently ignored when more than one tag is provided — Zerochan API limitation.
  • No write access: Zerochan's public API is fully read-only. Uploading, favoriting, and commenting are not supported.
  • No tag autocomplete: Zerochan does not expose a tag search/autocomplete endpoint in the JSON API. Use the website for tag discovery when needed.

🐛 Troubleshooting

ZEROCHAN_USERNAME is not set
- Add it to your client's "env" block, or: export ZEROCHAN_USERNAME="YourUsername"

Error 403 — Access denied
- Ensure your Zerochan username is correct and your account is in good standing.
- Blank or missing User-Agent strings are rejected by Zerochan.

Error 429 — Rate limit
- Wait 60 seconds and retry. Avoid paginating in rapid loops.

Error 404 — Not found
- The tag or entry ID does not exist on Zerochan. Check spelling; entry IDs come from post URLs.

Strict mode returns fewer results than expected
- By design — strict mode returns only entries where the tag is the primary classification. Use non-strict for broader results.


🤝 Contributing

Pull requests are welcome! If you find an API edge case not handled, a tag format inconsistency, or want to add a new filter, open an issue or PR.

Development Setup```bash

git clone https://github.com/citronlegacy/zerochan-mcp.git
cd zerochan-mcp
bash setup.sh
source .venv/bin/activate
```


📄 License

MIT License — see LICENSE for details.


🔗 Links

  • 🌐 Zerochan
  • 🔧 MCP documentation
  • 🗂️ MCP Registry
  • 🔍 Glama MCP Directory
  • 🎨 gelbooru-mcp — sister MCP server
  • 🐛 Bug Reports
  • 💡 Discussions

Relation to MultiBoru MCP

This server is one piece of a planned MultiBoru federated image board MCP that will aggregate Gelbooru, Danbooru, and Zerochan queries in parallel with cross-site tag normalization.

Site Max Tags Tag Format Auth
Gelbooru Many snake_case Optional API key
Danbooru 2 (free) / 6 (Gold) snake_case Optional
Zerochan Many Title Case Username in User-Agent

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
ZeroChan MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

ZeroChan MCP 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

ZeroChan MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

ZeroChan MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

ZeroChan MCP 能提供哪些能力?

资料显示能力标签包括 AI代理、工作流自动化、模型集成。具体工具清单以官方文档为准。

ZeroChan MCP 需要什么运行环境?

属于远程端点,不需要在本地装运行时。

ZeroChan MCP 是本地还是远程?

它是远程端点,连服务地址即可。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。