Danbooru Tags MCP Server

Danbooru 标签 MCP 服务器

通过MCP服务器，可以搜索Danbooru的标签信息和角色统计数据。

🎯 主要功能

工具 (Tools)

1. get_post_tags

提取特定Danbooru帖子的所有标签。

输入：

• post_id_or_url (string): 帖子ID或URL

输出示例：

{
  "post_id": 2973340,
  "url": "https://danbooru.donmai.us/posts/2973340",
  "total_tags": 47,
  "all_tags": ["1girl", "armpits", "black_boots", ...],
  "categories": {
    "general": ["1girl", "armpits", ...],
    "artist": ["ress"],
    "copyright": ["elsword"],
    "character": ["crimson_avenger_(elsword)", ...],
    "meta": []
  }
}

2. get_character_tags

分析角色常用标签的统计数据。

输入：

• character_tag （字符串，必填）：角色标签名
• num_posts （数字，可选）：要分析的帖子数量（默认：100）
• top_n (number, 可选): 要返回的顶级标签数量（默认：50）
• category （字符串，可选）：类别过滤器（general/artist/copyright/character/meta）
• include_tags (array, 可选): 必须包含的标签
• exclude_tags (array, 可选): 要排除的标签
• clothing_only (boolean, 可选): 仅返回服装标签

输出示例：

{
  "character_tag": "hatsune_miku",
  "posts_analyzed": 100,
  "filters": {
    "include_tags": ["tachi-e"]
  },
  "top_tags": [
    {"rank": 1, "tag": "hatsune_miku", "count": 100, "percentage": 100.0},
    {"rank": 2, "tag": "long_hair", "count": 90, "percentage": 90.0}
  ],
  "clothing_tags": [
    {"tag": "necktie", "count": 75, "percentage": 75.0}
  ]
}

3. get_wiki_info

在Danbooru Wiki上搜索标签/角色信息。

输入：

• tag_name (string): 标签名

输出示例：

{
  "title": "hatsune_miku",
  "other_names": ["初音ミク", "miku"],
  "body": "Hatsune Miku is a Japanese VOCALOID...",
  "body_formatted": "포맷팅된 본문",
  "created_at": "2007-09-12T17:15:58.073-04:00",
  "updated_at": "2025-09-13T13:43:39.561-04:00"
}

📦 安装及使用

在本地使用（config.json）

1. 打开Claude Desktop设置文件：

- Windows： %APPDATA%\Claude\claude_desktop_config.json - macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

1. 添加MCP服务器：

{
  "mcpServers": {
    "danbooru-tags": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli@latest",
        "run",
        "@gamzadongza/danbooru-tags-mcp"
      ]
    }
  }
}

1. 重启Claude Desktop

使用HTTPS URL（云端）

在Claude.ai或移动应用中添加以下URL：

https://server.smithery.ai/@gamzadongza/danbooru-tags-mcp/mcp?api_key=YOUR_API_KEY

💡 使用示例

提取帖子标签

User: 이 Danbooru 이미지의 태그를 분석해줘: https://danbooru.donmai.us/posts/2973340
Claude: [get_post_tags 도구 자동 호출]

角色标签统计

User: 하츠네 미쿠의 자주 사용되는 태그 100개 분석해줘
Claude: [get_character_tags 도구 자동 호출]

仅过滤站立式插图

User: 크림슨 어벤저의 스탠딩 일러스트에서 자주 나오는 의상 태그는?
Claude: [get_character_tags with include_tags: ["tachi-e"] 호출]

维基信息搜索

User: tachi-e 태그가 뭐야?
Claude: [get_wiki_info 도구 자동 호출]

🛠️ 开发

本地开发

# 의존성 설치
npm install

# TypeScript 빌드
npm run build

# 서버 실행
npm start

Docker 构建

docker build -t danbooru-tags-mcp .
docker run -p 3000:3000 danbooru-tags-mcp

📚 技术栈

• TypeScript - 类型安全性
• 快递 - HTTP服务器
• MCP SDK（MCP软件开发工具包） - 实现模型上下文协议
• SSE服务器传输（或SSE服务器通道） - 支持服务器发送事件（Server-Sent Events）

🔗 相关链接

• Danbooru API 文档： https://danbooru.donmai.us/wiki_pages/help:api 的中文翻译为：“丹博库（Danbooru）帮助页面：API”
• MCP官方文档： https://modelcontextprotocol.io/（中文可表述为：模型上下文协议网站）
• Smithery（此处可能指与“Smith”相关的某种工艺或技术，但具体含义需根据上下文确定，若直接翻译则为“史密斯工艺/技术”或类似表述，但在此保留原样以体现其可能的特定含义）: https://smithery.ai（该网址可直接翻译为“史密斯里人工智能网站”，但具体名称可能需根据实际网站内容或品牌翻译进行调整，此处为直译）

📄 许可证

麻省理工学院（MIT）

👤 作者

“gamzadongza”这个词汇看起来像是一个特定语境或虚构语言中的表达，直接翻译可能没有明确的对应意义。如果尝试将其拆解并赋予一定的想象性翻译，可以大致理解为“游戏中的奇妙冒险”或“虚拟世界的奇妙旅程”，但请注意，这仅是一个基于词汇结构的创造性翻译，并非该词在任何实际语言中的标准含义

• GitHub链接：https://github.com/gamzadongza
• 相关项目：

- Turso-MCP-Server（注：这里的“Turso”可能是一个特定的项目或服务名称，而“MCP-Server”通常指的是某种主控程序或管理控制面板服务器，但具体含义需根据上下文确定。在此直接翻译为“Turso-MCP-服务器”以保持原样，实际应用中可能需要根据具体情况调整。） - danbooru-turso-mcp