sbwsz-mcp

大学院废墟(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
  活字乱刷，将输入的文本使用万智牌卡牌图像拼接成图片。

使用方法

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

1. 标准 stdio 模式（默认）
2. 无状态 Streamable HTTP 模式，提供 HTTP 端点

使用 NPX

如果你本地安装了 Node.js：

连接到服务端

Stdio 模式

你的应用程序或环境（如 Claude Desktop）可以通过 stdio 直接与服务端通信。

Streamable HTTP 模式

当使用 Streamable HTTP 模式运行时（使用 --http 参数）：

服务端将在以下端点可用：

• Streamable HTTP 端点：http://localhost:3000/mcp

该模式为无状态模式，不维护会话信息，提供更简化和高效的通信方式。

在 claude_desktop_config.json 中集成

stdio 模式的示例配置：

或使用 npx：

使用 Docker 构建

然后你可以在 stdio 模式下运行：

或在 Streamable HTTP 模式下运行：