CosplayTele MCP

面向 CosplayTele 及同类图库站点的 MCP 2（Model Context Protocol，规范 2026-07-28）服务器。

源

工具

• list_sources：源目录
• search(query, source=all, page=1, category?, exclude_ai=true)：按站点真实接口搜索。source=all 时并行查全部源
• browse(source, sort=popular|latest, page=1, query?, category?, exclude_ai=true)：排行 / 最新；带 query 时走该源搜索
• get_gallery(source, path)：详情和图片 URL；path 用列表或搜索结果里的 path，也接受完整帖子 URL

exclude_ai 默认开启。只认明确 AI 标记，避免误伤 Ai Yamada、Ai Hoshino 这类名字：

结果里带 is_ai。get_gallery 仍会返回 AI 图集，只打标不拦截。

搜索实现：

资源：sources://catalog、gallery://{source}/{+path}。提示词：find_gallery。

运行

需要 Python 3.10+ 和 uv。

cd /home/begonia/Documents/Github/XeroTeam/cosplaytele-mcp
uv sync --dev
uv run ruff check src tests
uv run ruff format --check src tests
uv run pytest
uv run mcp dev src/cosplaytele_mcp/server.py

格式化：

uv run ruff format src tests
uv run ruff check --fix src tests

stdio 启动（给宿主用）：

uv run cosplaytele-mcp
# 或
uv run mcp run src/cosplaytele_mcp/server.py

HTTP：

uv run python -c "from cosplaytele_mcp.server import mcp; mcp.run(transport='streamable-http', port=8000)"

接入宿主

把 uv 和项目路径换成本机绝对路径。

Claude Desktop / Cursor（mcpServers）：

{
  "mcpServers": {
    "cosplaytele": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/home/begonia/Documents/Github/XeroTeam/cosplaytele-mcp",
        "cosplaytele-mcp"
      ]
    }
  }
}

VS Code .vscode/mcp.json：

{
  "servers": {
    "cosplaytele": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/home/begonia/Documents/Github/XeroTeam/cosplaytele-mcp",
        "cosplaytele-mcp"
      ]
    }
  }
}