百鸽(ygocdb.com) MCP Server

What is 百鸽(ygocdb.com) MCP Server?

一个基于 Model Context Protocol (MCP) 的服务端，用于与百鸽 (ygocdb.com) 等 API 交互，提供查询游戏王中文卡牌信息的工具。适合需要程序化搜索卡牌、获取卡牌详情和图片的开发者或 MCP 客户端用户。

How to use 百鸽(ygocdb.com) MCP Server?

通过 NPM 全局安装 (npm install -g ygocdb-mcp-server) 或直接使用 npx ygocdb-mcp-server 运行。支持 STDIO 模式（默认，用于 Claude Desktop 等客户端）和 HTTP 模式（端口 8081，用于容器部署）。也可通过 Docker 构建镜像并运行。

Key features of 百鸽(ygocdb.com) MCP Server

• search_cards：通过关键字搜索游戏王卡牌。
• get_card_by_id：通过 ID 获取单张卡牌详细信息。
• get_card_image：通过 ID 获取卡牌图片。
• 支持 STDIO 和 HTTP 两种运行模式。
• 集成 Claude Desktop 等 MCP 客户端。
• 提供 Docker 部署与跨平台支持。

Use cases of 百鸽(ygocdb.com) MCP Server

• 在 Claude 等 AI 助手中快速查询游戏王卡牌信息。
• 自动化获取卡牌效果文本用于攻略或数据库维护。
• 通过 HTTP 接口将卡牌数据集成到自建卡片管理工具中。
• 使用 Docker 部署到服务器，提供稳定的 API 查询服务。

FAQ from 百鸽(ygocdb.com) MCP Server

如何安装百鸽 MCP 服务器？

推荐全局安装 npm install -g ygocdb-mcp-server，或直接使用 npx ygocdb-mcp-server 运行。

支持哪些运行模式？

支持 STDIO 模式（默认，用于集成到 MCP 客户端）和 HTTP 模式（端口 8081，用于容器部署或 HTTP 客户端访问）。

如何集成到 Claude Desktop？

在 claude_desktop_config.json 中添加 mcpServers 配置，command 设为 npx，args 设为 ["ygocdb-mcp-server"]。

如何使用 Docker 部署？

构建镜像：docker build -t ygocdb-mcp .；运行 STDIO 模式：docker run -i --rm ygocdb-mcp；运行 HTTP 模式：docker run -p 8081:8081 ygocdb-mcp。

在哪些平台上可以运行？

支持 Windows、macOS、Linux，通过 cross-env 确保环境变量正确设置。Docker 自动使用 HTTP 模式。