百鸽(ygocdb.com) MCP Server

English | 中文

一个基于 Model Context Protocol (MCP) 的服务端，用于与 百鸽(ygocdb.com)等 API 交互。提供了一系列工具来查询游戏王中文卡牌信息。

API 文档

本服务端基于游戏王卡牌数据库的公开 API。

• 卡牌搜索: https://ygocdb.com/api/v0/?search=关键字

• 卡牌图片: https://cdn.233.momobako.com/ygopro/pics/<id>.jpg

使用示例

功能特性

• search_cards
  通过关键字搜索游戏王卡牌，可以搜索卡牌名称、效果文本等。

• get_card_by_id
  通过卡牌ID获取单张游戏王卡牌的详细信息。

• get_card_image
  通过卡牌ID获取游戏王卡牌的图片。

使用方法

通过 NPM 包使用

本地开发

运行模式

服务端支持两种运行模式：

STDIO 模式（默认）

用于与 Claude Desktop 等 MCP 客户端直接集成：

HTTP 模式

用于容器部署或 HTTP 客户端访问：

HTTP 服务器将在端口 8081 上启动，端点为 http://localhost:8081/mcp

在 Claude Desktop 中集成

在 claude_desktop_config.json 中添加配置：

使用 NPX（推荐）

使用本地构建

Docker 部署

跨平台支持

项目使用 cross-env 确保在所有平台上正确设置环境变量：

• Windows: npm run start:http 或 npm run start:stdio

• macOS/Linux: npm run start:http 或 npm run start:stdio

• Docker: 自动使用 HTTP 模式