DeepSeek Harness (DSH) 提供了插件化扩展能力。当智能体需要处理万智牌相关的数据时,直接硬编码数据库既不灵活也不便于维护。xby-gathering-card-lookup-service 解决了这个问题,它是一个基于 Model Context Protocol (MCP) 的服务端,专门提供万智牌中文卡牌信息的查询和搜索功能。
该插件由 xby-skill 维护,属于联网工具分类。它通过标准的 DSH 插件接口,将卡牌查询能力挂载到对话流中。
核心功能¶
插件提供以下主要接口:
set_xby_apikey:设置 API 密钥,配置会自动持久化,重启有效。get_card_by_set_and_number:通过系列代码和收集编号获取单张卡牌详情。search_cards:通过查询字符串搜索卡牌,支持分页和排序。get_sets/get_set/get_set_cards:提供系列数据的查询与获取。hzls:活字乱刷,支持将输入文本使用卡牌图像拼接成图片。
安装¶
使用官方命令从 GitHub 安装插件:
dsh plugin --profile web add github:xby_skill/xby-gathering-card-lookup-service
配置与使用¶
- 获取密钥:前往小笨羊官网注册并获取 API 密钥。
- 设置密钥:在 DSH 聊天中使用
set_xby_apikey功能设置密钥。 - 搜索示例:
*t:creature c:r(红色生物)
*pow>=5 or mv<2(力量大于等于5或法术力值小于2)
*o:"draw a card" -c:u(包含”抓一张牌”的非蓝色牌) - 参数说明:
* 分页:page(页码, 默认 1),page_size(每页数量, 默认 20, 最大 100)
* 排序:order(字段名, 逗号分隔), 前缀-表示降序 (如name,-mv)
* 其他:unique(去重方式),priority_chinese(优先中文)
注意事项¶
- 插件以当前 DSH 进程权限运行。
- 安装前建议检查 GitHub 源码与许可证(MIT)。
- API 密钥需在小笨羊官网获取。