ygocdb-mcp

百鸽(ygocdb.com) MCP Server

| 中文

一个基于 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获取游戏王卡牌的图片。

使用方法

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

1. 标准 stdio 模式（默认）
2. 无状态 Streamable HTTP 模式，提供 HTTP 端点

使用 NPX

如果你本地安装了 Node.js：

# Stdio 模式
npx ygocdb-mcp-server

# Streamable HTTP 模式
npx ygocdb-mcp-server --http

连接到服务端

Stdio 模式

你的应用程序或环境（如 Claude Desktop）可以通过 stdio 直接与服务端通信。

Streamable HTTP 模式

当使用 Streamable HTTP 模式运行时（使用 --http 参数）：

服务端将在以下端点可用：

• Streamable HTTP 端点：http://localhost:3000/mcp

该模式为无状态模式，不维护会话信息，提供更简化和高效的通信方式。

在 claude_desktop_config.json 中集成

stdio 模式的示例配置：

{
  "mcpServers": {
    "ygocdb": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "mcp/ygocdb"]
    }
  }
}

或使用 npx：

{
  "mcpServers": {
    "ygocdb": {
      "command": "npx",
      "args": ["ygocdb-mcp-server"]
    }
  }
}

使用 Docker 构建

docker build -t mcp/ygocdb .

然后你可以在 stdio 模式下运行：

docker run -i --rm mcp/ygocdb

或在 Streamable HTTP 模式下运行：

docker run -i --rm -p 3000:3000 mcp/ygocdb --http