MTG Chinese Card Database - 大学院废墟(sbwsz.com)

Name: MTG Chinese Card Database - 大学院废墟(sbwsz.com)
Rating: 0.1 (1 reviews)
Author: lieyanqzu

数据与存储

by lieyanqzu

通过强大的查询工具无缝访问 Magic: The Gathering 中文卡牌数据，支持复杂条件检索、系列查询和卡牌详情获取，并可通过 stdio 或 Streamable HTTP 灵活集成。

1GitHub

什么是 MTG Chinese Card Database - 大学院废墟(sbwsz.com)？

通过强大的查询工具无缝访问 Magic: The Gathering 中文卡牌数据，支持复杂条件检索、系列查询和卡牌详情获取，并可通过 stdio 或 Streamable HTTP 灵活集成。

核心功能 (6 个工具)

get_card_by_set_and_number

通过系列代码和收集编号获取单张卡牌。

search_cards

通过查询字符串搜索卡牌，支持分页和排序。 **查询语法示例:** - `t:creature c:r` (红色生物) - `pow>=5 or mv<2` (力量大于等于5或法术力值小于2) - `o:"draw a card" -c:u` (包含"抓一张牌"的非蓝色牌) - `(t:instant or t:sorcery) mv<=3` (3费或以下的瞬间或法术) **分页参数:** - `page`: 页码 (整数, 默认 1) - `page_size`: 每页数量 (整数, 默认 20, 最大 100) **排序参数:** - `order`: 按字段排序，逗号分隔。前缀 `-` 表示降序 (例如: `name`, `-mv`, `name,-rarity`) 默认排序: `name` **其他参数:** - `unique`: 去重方式 (id, oracle_id, illustration_id) - `priority_chinese`: 是否优先显示中文卡牌

get_sets

返回所有MTG卡牌系列的完整数据，按发布日期降序排列

get_set

根据系列代码获取单个系列的详细信息

get_set_cards

获取特定系列的所有卡牌，支持分页和排序。

hzls

活字乱刷（使用卡牌图像拼接句子），将输入的文本使用魔法卡牌图像拼接成图片

README

大学院废墟(sbwsz.com) MCP Server

English | 中文

一个基于 Model Context Protocol (MCP) 的服务端，用于与大学院废墟 API 交互。提供了一系列工具来查询万智牌中文卡牌信息。

API 文档

本服务端基于大学院废墟的公开 API。您可以在以下地址查看完整的 API 文档：

大学院废墟 API 文档

使用示例

功能特性

get_card_by_set_and_number
通过系列代码和收集编号获取单张卡牌。
search_cards
通过查询字符串搜索卡牌，支持分页和排序。支持复杂的查询语法，如 t:creature c:r（红色生物）或 pow>=5 or mv<2（力量大于等于5或法术力值小于2）。
get_sets
获取所有卡牌系列的信息。
get_set
获取单个系列的详细信息。
get_set_cards
获取特定系列的所有卡牌，支持分页和排序。
hzls
活字乱刷，将输入的文本使用万智牌卡牌图像拼接成图片。

使用方法

通过 NPM 包使用

bash

# 全局安装
npm install -g sbwsz-mcp-server

# 或直接运行（推荐）
npx sbwsz-mcp-server

本地开发

bash

# 克隆项目
git clone <repository-url>
cd sbwsz-mcp

# 安装依赖
npm install

# 构建项目
npm run build

# 运行 STDIO 模式
npm run start:stdio

# 运行 HTTP 模式
npm run start:http

运行模式

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

STDIO 模式（默认）

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

bash

npm run start:stdio

HTTP 模式

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

bash

npm run start:http

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

在 Claude Desktop 中集成

在 claude_desktop_config.json 中添加配置：

使用 NPX（推荐）

json

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

使用本地构建

json

{
  "mcpServers": {
    "sbwsz": {
      "command": "node",
      "args": ["path/to/sbwsz-mcp/dist/index.js"],
      "cwd": "path/to/sbwsz-mcp"
    }
  }
}

Docker 部署

bash

# 构建镜像
docker build -t sbwsz-mcp .

# 运行 STDIO 模式（用于集成）
docker run -i --rm sbwsz-mcp

# 运行 HTTP 模式（用于服务）
docker run -p 8081:8081 sbwsz-mcp

跨平台支持

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

Windows: npm run start:http 或 npm run start:stdio
macOS/Linux: npm run start:http 或 npm run start:stdio
Docker: 自动使用 HTTP 模式

常见问题