# 万智牌卡牌查询服务 

一个基于Model Context Protocol (MCP)的服务端，提供万智牌中文卡牌信息的查询和搜索功能。
A server based on Model Context Protocol (MCP) that provides query and search functions for Chinese card information of Wanzhi brand.## 工具列表 Tool List

本MCP服务封装下列工具，可让模型通过标准化接口调用以下功能。 本MCP服务封装下列工具，可让模型通过标准化接口调用以下功能。

| 工具 Tool   | 描述 Description         |
|-------|--------------------|
| 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 | 活字乱刷（使用卡牌图像拼接句子），将输入的文本使用魔法卡牌图像拼接成图片 |


## 检查服务 ## Inspector

工具在线测试： [https://mcp.xiaobenyang.com/inspector/1777316659870723](https://mcp.xiaobenyang.com/inspector/1777316659870723)

Online Tool test [https://mcp.xiaobenyang.com/inspector/1777316659870723](https://mcp.xiaobenyang.com/inspector/1777316659870723)

## 服务配置 MCP Server Config


> #### 如何获取 XBY-APIKEY ？ How to get XBY-APIKEY ?
> 访问小笨羊科技网站 [https://xiaobenyang.com](https://xiaobenyang.com)，注册用户即可获得APIKEY
> Visit XiaoBenYang website [https://xiaobenyang.com](https://xiaobenyang.com), register and get the APIKEY.

### SSE
```json
{
  "mcpServers": {
    "万智牌卡牌查询服务": {
      "headers": {
        "XBY-APIKEY": "<YOUR_XBY_APIKEY>"
      },
      "type": "sse",
      "url": "https://mcp.xiaobenyang.com/1777316659870723/sse"
    }
  }
}
```
### STREAMABLE HTTP
```json
{
  "mcpServers": {
    "万智牌卡牌查询服务": {
      "headers": {
        "XBY-APIKEY": "<YOUR_XBY_APIKEY>"
      },
      "type": "streamable_http",
      "url": "https://mcp.xiaobenyang.com/1777316659870723/mcp"
    }
  }
}
```
### STDIO
```json
{
    "mcpServers": {
        "万智牌卡牌查询服务": {
          "command": "npx",
          "args": [
            "-y",
            "xiaobenyang-mcp"
          ],
          "env": {
            "XBY_APIKEY": "<YOUR_XBY_APIKEY>",
            "mcpId": "1777316659870723",
          },
          "transport": "stdio"
        }
      }
}

```