Sbwsz MCP

🚀 大学院废墟(sbwsz.com) MCP サーバー

Model Context Protocol (MCP) をベースにしたサーバーで、大学院废墟 API とのやり取りを行います。マジック・ザ・ギャザリングの中国語カード情報を照会するための一連のツールを提供します。

🚀 クイックスタート

このサーバーは、大学院废墟 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
  入力されたテキストをマジック・ザ・ギャザリングのカード画像で構成された画像に変換します。

📦 インストール

サーバーは2つの実行モードをサポートしています。

1. 標準の stdio モード（デフォルト）
2. ステートレスな 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