MTG Assistant

MCP Server MTG Assistant

一个 Model Context Protocol 服务，通过 Scryfall API 提供万智牌卡牌信息查询功能。

规则问题示例工作流

虽然本服务主要用于查询特定卡牌的详细信息，但也可以作为回答万智牌规则问题的关键第一步。

用户提问：“如果我施放一个 X=10 的 Finale of Devastation，并搜索 Avenger of Zendikar，那些衍生物也会获得 +10/+10 和敏捷吗，还是不会？”

可用工具

• get_mtg_card_info - 从 Scryfall 检索特定万智牌的详细信息。
  • query (string, 必填)：搜索查询字符串（例如卡牌名称、部分名称或特征）

安装和运行

本项目使用 uv 管理依赖项并运行脚本。

使用 uv（推荐）

确保已安装 uv。你可以直接从项目目录运行服务：

# Navigate to the project root directory first
cd path/to/mcp-servers/mcp-mtg-assistant

# Install dependencies (if needed) and run the server script
uv run mcp-server-mtg-assistant

使用 PIP（用于分发或其他设置方式）

如果该软件包已发布，你可以通过 pip 安装：

pip install mcp-server-mtg-assistant

安装后，你可以将其作为脚本运行：

python -m mcp_server_mtg_assistant

开发时，通常如上所示，使用 uv run 运行。

配置

为 MCP 客户端配置（例如 Claude.app、Inspector）

在客户端的 MCP 服务配置中添加一项。键名（示例中的 "mtg-assistant"）可以自行选择。

**重要：**配置需要通过 --directory 参数指定 uv 所指向的正确项目目录。路径格式（/ 或 \）取决于你的操作系统以及运行 uv 的方式。

// Example for mcp.json or Claude settings
"mcpServers": {
  "mtg-assistant": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/mcp-servers/mcp-mtg-assistant", // Unix-style path
      "run",
      "mcp-server-mtg-assistant"
    ]
  }
}

// Example for mcp.json or Claude settings on Windows
"mcpServers": {
  "mtg-assistant": {
    "command": "wsl.exe",
    "args": [
      "/home/your-user/.cargo/bin/uv", // uv WSL PATH
      "--directory",
      "/mnt/d/repos/mcp-servers/mcp-mtg-assistant", // WSL-style path to project
      "run",
      "mcp-server-mtg-assistant"
    ]
  }
}

// Example for mcp.json or Claude settings on Windows
"mcpServers": {
  "mtg-assistant": {
    "command": "uv",
    "args": [
      "--directory",
      "D:\path\to\mcp-servers\mcp-mtg-assistant", // Windows-style path
      "run",
      "mcp-server-mtg-assistant"
    ]
  }
}

处理 .venv 冲突（不同环境）

• 问题：uv run 会创建一个与操作系统／环境对应的 .venv 目录（例如 Linux 与 Windows）。如果你在 Windows 上直接运行服务和通过 WSL（或原生 Linux）运行服务之间切换，现有的 .venv 可能不兼容。
• **解决方案：**切换环境前，删除 mcp-mtg-assistant 项目根目录中的 .venv 目录。之后，uv run 会为你正在使用的环境创建一个兼容的新目录。

调试

你可以在配置中的命令和参数前添加 npx @modelcontextprotocol/inspector，使用 MCP inspector 调试服务。

# Example using the Default (Linux/macOS/WSL) configuration:
npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-servers/mcp-mtg-assistant run mcp-server-mtg-assistant

# Example using the Recommended (Windows Client + WSL Server) configuration:
npx @modelcontextprotocol/inspector wsl.exe /home/your-user/.cargo/bin/uv --directory /mnt/d/repos/mcp-servers/mcp-mtg-assistant run mcp-server-mtg-assistant

# Example using the Alternative (Direct Windows) configuration:
npx @modelcontextprotocol/inspector uv --directory D:\path\to\mcp-servers\mcp-mtg-assistant run mcp-server-mtg-assistant

贡献

欢迎贡献，帮助扩展和改进此 MTG Assistant MCP 服务。无论是添加新功能、增强现有功能，还是改进文档，你的贡献都很有价值。

其他 MCP 服务和实现模式示例，请参阅： https://github.com/modelcontextprotocol/servers

欢迎提交拉取请求！欢迎贡献新想法、错误修复或改进内容。

许可证

mcp-server-mtg-assistant 根据 MIT License 获得许可。这意味着你可以自由使用、修改和分发该软件，但须遵守 MIT License 的条款和条件。