大学院废墟(sbwsz.com) MCP Server

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

English | 中文

Model Context Protocol (MCP) に基づくサーバーで、大学院废墟 API と連携します。中国語版のマジック：ザ・ギャザリングのカード情報を検索するための一連のツールを提供します。

API ドキュメント

このサーバーは大学院废墟の公開 API に基づいています。以下のリンクから、API ドキュメントの全文を確認できます。

• 大学院废墟 API ドキュメント

使用例

機能

• get_card_by_set_and_number
  セットコードとコレクター番号を指定して、1枚のカードを取得します。
• search_cards
  クエリ文字列でカードを検索します。ページネーションと並べ替えに対応しています。t:creature c:r（赤のクリーチャー）や pow>=5 or mv<2（パワーが5以上、またはマナ総量が2未満）など、複雑なクエリ構文にも対応しています。
• get_sets
  すべてのカードセットの情報を取得します。
• get_set
  1つのセットの詳細情報を取得します。
• get_set_cards
  指定したセットのすべてのカードを取得します。ページネーションと並べ替えに対応しています。
• hzls
  活字乱刷：入力したテキストをマジック：ザ・ギャザリングのカード画像でつなぎ合わせて画像を作成します。

使用方法

NPM パッケージを使用する

# 全局安装
npm install -g sbwsz-mcp-server

# 或直接运行（推荐）
npx sbwsz-mcp-server

ローカルでの開発

# 克隆项目
git clone <repository-url>
cd sbwsz-mcp

# 安装依赖
npm install

# 构建项目
npm run build

# 运行 STDIO 模式
npm run start:stdio

# 运行 HTTP 模式
npm run start:http

実行モード

サーバーは2つの実行モードに対応しています。

STDIO モード（デフォルト）

Claude Desktop などの MCP クライアントと直接連携する場合に使用します。

npm run start:stdio

HTTP モード

コンテナーへのデプロイや HTTP クライアントからのアクセスに使用します。

npm run start:http

HTTP サーバーはポート 8081 で起動し、エンドポイントは http://localhost:8081/mcp です。

Claude Desktop との連携

claude_desktop_config.json に設定を追加します。

NPX を使用する（推奨）

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

ローカルビルドを使用する

{
  "mcpServers": {
    "sbwsz": {
      "command": "node",
      "args": ["path/to/sbwsz-mcp/dist/index.js"],
      "cwd": "path/to/sbwsz-mcp"
    }
  }
}

Docker へのデプロイ

# 构建镜像
docker build -t sbwsz-mcp .

# 运行 STDIO 模式（用于集成）
docker run -i --rm sbwsz-mcp

# 运行 HTTP 模式（用于服务）
docker run -p 8081:8081 sbwsz-mcp

クロスプラットフォーム対応

プロジェクトでは cross-env を使用して、すべてのプラットフォームで環境変数を正しく設定します。

• Windows: npm run start:http または npm run start:stdio
• macOS/Linux: npm run start:http または npm run start:stdio
• Docker: HTTP モードが自動的に使用されます