Ygocdb MCP

🚀 百鴿(ygocdb.com) MCP Server

百鴿(ygocdb.com) MCP Server 是一個基於 Model Context Protocol (MCP) 的服務端，可與 百鴿(ygocdb.com)等 API 交互。它提供了一系列工具，方便用戶查詢遊戲王中文卡牌信息。

English | 中文

🚀 快速開始

本服務端基於遊戲王卡牌數據庫的公開 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 獲取遊戲王卡牌的圖片。

💻 使用示例

基礎用法

📚 詳細文檔

API 文檔

本服務端基於遊戲王卡牌數據庫的公開 API，具體如下：

• 卡牌搜索: https://ygocdb.com/api/v0/?search=關鍵字
• 卡牌圖片: https://cdn.233.momobako.com/ygopro/pics/<id>.jpg

使用方法

服務端支持兩種運行模式：

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