ygocdb

This MCP server provides tools to interact with ygocdb.com data via the Model Context Protocol. It exposes capabilities to search for Yu-Gi-Oh! cards, retrieve detailed information for a specific card by its ID, and fetch card images. You can run the server in two modes: STDIO for direct MCP client integration (e.g., Claude Desktop) and HTTP for containerized deployments or HTTP clients. In STDIO mode, the server communicates over standard input/output, while HTTP mode serves an HTTP API at port 8081 with an endpoint like /mcp.

To use the server, install and run it, then query the available MCP endpoints through your MCP client. Typical actions include: searching cards by keywords, obtaining a card by its ID, and requesting a card image by ID. If you’re integrating with Claude Desktop, you can configure the mcpServers section to point to this server via NPM or a local build path as shown in the integration instructions.

Prerequisites:

• Node.js and npm installed on your machine
• Git for cloning the repository (optional if using npm/pnpm)

Installation steps:

1. Clone or install via npm/npx:

   • Global installation (recommended for quick start): npm install -g ygocdb-mcp-server
   • Or run directly with NPX (no local install): npx ygocdb-mcp-server

2. If developing locally from source: git clone <repository-url> cd ygocdb-mcp npm install

3. Build (if required by the project): npm run build

4. Run in STDIO mode (default for MCP clients): npm run start:stdio

5. Run in HTTP mode (for HTTP access): npm run start:http

Note: The HTTP server will start on port 8081 and expose the MCP endpoint at http://localhost:8081/mcp.

Environment and deployment tips:

• HTTP mode runs on port 8081 by default; use -p 8081:8081 in Docker if you need to map ports.
• If integrating with Claude Desktop, you can use NPX to fetch and run the MCP server directly, or point to a local build via Node.
• This project uses cross-env to normalize environment variables across platforms, ensuring consistent behavior on Windows, macOS, Linux, and Docker.
• Docker deployment: Build the image with docker build -t ygocdb-mcp . and run with either the STDIO or HTTP mode depending on your use case.
• Available actions include search_cards, get_card_by_id, and get_card_image; consult the API documentation in the README for exact endpoints and query formats.