大学院废墟(sbwsz.com) MCP Server
English | 中文
一个基于 Model Context Protocol (MCP) 的服务端，用于与 大学院废墟 API 交互。提供了一系列工具来查询万智牌中文卡牌信息。
API 文档
本服务端基于大学院废墟的公开 API。您可以在以下地址查看完整的 API 文档：
使用示例
功能特性
- get_card_by_set_and_number
通过系列代码和收集编号获取单张卡牌。
- search_cards
通过查询字符串搜索卡牌，支持分页和排序。支持复杂的查询语法，如 t:creature c:r（红色生物）或 `pow>=5 or mv cd sbwsz-mcp
安装依赖
npm install
构建项目
npm run build
运行 STDIO 模式
npm run start:stdio
运行 HTTP 模式
npm run start:http
### 运行模式
服务端支持两种运行模式：
#### 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 模式