Sbwsz MCP

🚀 大學院廢墟(sbwsz.com) MCP 服務端

這是一個基於 Model Context Protocol (MCP) 的服務端，主要用於和 大學院廢墟 API 進行交互。它提供了一系列實用工具，可用於查詢萬智牌中文卡牌的相關信息。

English | 中文

🚀 快速開始

本服務端支持兩種運行模式，分別是標準 stdio 模式（默認）和無狀態 Streamable HTTP 模式（提供 HTTP 端點）。下面為你詳細介紹不同方式的使用方法。

使用 NPX

若你本地已經安裝了 Node.js，可按以下命令操作：

# Stdio 模式
npx sbwsz-mcp-server

# Streamable HTTP 模式
npx sbwsz-mcp-server --http

連接到服務端

Stdio 模式

你的應用程序或環境（例如 Claude Desktop）能夠通過 stdio 直接和服務端進行通信。

Streamable HTTP 模式

當使用 --http 參數以 Streamable HTTP 模式運行時，服務端將在以下端點可用：

• Streamable HTTP 端點：http://localhost:3000/mcp 此模式為無狀態模式，不會維護會話信息，能提供更簡化且高效的通信方式。

在 claude_desktop_config.json 中集成

以下是 stdio 模式的示例配置：

{
  "mcpServers": {
    "sbwsz": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "mcp/sbwsz"]
    }
  }
}

或者使用 npx：

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

使用 Docker 構建

docker build -t mcp/sbwsz .

構建完成後，你可以在 stdio 模式下運行：

docker run -i --rm mcp/sbwsz

也可以在 Streamable HTTP 模式下運行：

docker run -i --rm -p 3000:3000 mcp/sbwsz --http

✨ 主要特性

• 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：活字亂刷功能，可將輸入的文本使用萬智牌卡牌圖像拼接成圖片。

💻 使用示例

📚 詳細文檔

本服務端基於大學院廢墟的公開 API。你可以在以下地址查看完整的 API 文檔：

• 大學院廢墟 API 文檔