xby-gathering-card-lookup-service

Readme

# xby-gathering-card-lookup-service

DeepSeek Harness (DSH) 的插件：万智牌卡牌查询服务

一个基于Model Context Protocol (MCP)的服务端，提供万智牌中文卡牌信息的查询和搜索功能。

## 功能

- **set_xby_apikey** — 在聊天中设置 API 密钥（自动持久化，重启有效）
- **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** — 活字乱刷（使用卡牌图像拼接句子），将输入的文本使用魔法卡牌图像拼接成图片

## 安装

### 方式一：从 GitHub 直接安装（推荐）

```bash
# 格式: dsh plugin --profile <profile> add github:<owner>/<repo>
dsh plugin --profile web add github:xby_skill/xby-gathering-card-lookup-service
```

### 方式二：从本地目录安装（开发模式）

```bash
# 仅用于本地开发调试
dsh plugin --profile web add /absolute/path/to/xby-gathering-card-lookup-service
```

### 方式三：通过 cordis.patch.yml 开发调试

```bash
dsh web --profile web --patch /absolute/path/to/dsh-ocr-plugin/cordis.patch.yml
```



## 配置

### 获取 API 密钥

前往 [小笨羊官网](https://xiaobenyang.com) 注册并获取 API 密钥。