SBWSZ

This MCP Server provides an interface to the 大学院废墟 API to query Chinese MTG card data. It exposes endpoints and tooling that let you search cards, retrieve sets, fetch specific cards, and generate image stitched card visuals through a simple MCP bridge that works with your MCP clients.

How to use

You connect to the server with your MCP client and use its card querying and browsing capabilities. The server exposes a set of endpoints that let you search across cards, fetch cards by set and number, list sets, and retrieve cards from a specific set. You can also generate image composites from card inputs. Use the MCP client’s standard request flow to call the server, then process the returned data or images within your workflow.

Typical patterns you’ll use include searching for cards with query operators, listing available card sets, and paging through results. When you need a single card, use the set code and card number to fetch that card directly. When working with a specific set, request all cards within that set and apply your client’s display or filtering logic on the results. For image stitching, provide your text input and let the server return a generated image containing card visuals.

How to install

Prerequisites: ensure Node.js and npm are installed on your system.

Check Node.js and npm versions to verify your environment.

node -v
npm -v

Install and run in STDIO mode

STDIO mode is the default and is designed for direct integration with MCP clients like Claude Desktop. Install the MCP server locally and run it via npm.

# Install dependencies and prepare the project for local use
# You can install globally or run via npx as shown below

# Global installation (optional)
npm install -g sbwsz-mcp-server

# Run in STDIO mode (preferred for MCP client integration)
npm run start:stdio

Install and run in HTTP mode (for container or HTTP client access)

HTTP mode serves the MCP API over HTTP for containerized setups or HTTP-based clients. Start the HTTP server on port 8081 at the /mcp endpoint.

# Run in HTTP mode
npm run start:http

Docker deployment

You can containerize the server with Docker for easy deployment and isolation.

# Build the Docker image
docker build -t sbwsz-mcp .

# Run in STDIO mode (integration-friendly)
docker run -i --rm sbwsz-mcp

# Run in HTTP mode (service-ready)
docker run -p 8081:8081 sbwsz-mcp

Configuration notes

Two run modes are supported, with the HTTP server automatically serving on port 8081 at http://localhost:8081/mcp when started in HTTP mode. The STDIO mode is designed for direct MCP client integration without HTTP networking.

Notes on integration with Claude Desktop

To integrate with Claude Desktop, configure the MCP server in your Claude Desktop settings. The suggested approach is to use NPX for a quick start or point to a locally built runtime if you prefer.

Available tools

get_card_by_set_and_number

Fetch a single card by its set code and collector number.

search_cards

Search cards with a query string, with support for pagination and sorting, including complex queries.

get_sets

Retrieve information about all card sets.

get_set

Retrieve detailed information for a single card set.

get_set_cards

Get all cards from a specific set with paging and sorting options.

hzls

Generate an image by stitching card artwork from provided text input.