CosplayTele MCP

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

需要 Python 3.10+。已发布：cosplaytele-mcp。

安装

uvx cosplaytele-mcp

uvx 会临时拉取包并走 stdio 启动，适合直接接到宿主。持久安装：

uv tool install cosplaytele-mcp
# 或
pip install cosplaytele-mcp

装完后命令是 cosplaytele-mcp。

接入宿主

推荐用 uvx，不必克隆仓库。若宿主找不到 uvx，把 command 换成 uvx 的绝对路径（常见是 ~/.local/bin/uvx）。

Claude Desktop / Cursor（mcpServers）：

{
  "mcpServers": {
    "cosplaytele": {
      "command": "uvx",
      "args": ["cosplaytele-mcp"]
    }
  }
}

已用 uv tool install 或 pip install 时：

{
  "mcpServers": {
    "cosplaytele": {
      "command": "cosplaytele-mcp"
    }
  }
}

VS Code .vscode/mcp.json：

{
  "servers": {
    "cosplaytele": {
      "type": "stdio",
      "command": "uvx",
      "args": ["cosplaytele-mcp"]
    }
  }
}

运行

stdio（给宿主用）：

uvx cosplaytele-mcp
# 或已安装后
cosplaytele-mcp

HTTP：

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

源

工具

• 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。

开发

克隆仓库后用 uv：

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