MTG卡牌查询服务

一个提供与Magic the Gathering API交互工具的模型上下文协议(MCP)服务器,支持按名称、属性搜索卡牌,获取详细信息和随机卡牌。

  • by benjadrejer
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 benjadrejer/MTG_MCP

使用说明

MTG MCP 服务器

一个提供与《万智牌》API交互工具的模型上下文协议(MCP)服务器。

特点/特性

  • 通过名称部分匹配搜索MTG卡牌
  • 按各种属性(颜色、类型、法力值消耗等)筛选卡牌
  • 获取详细的卡片信息
  • 获取关于MTG(万智牌)卡牌系列的信息
  • 发现随机卡片

安装

开发环境设置

  1. 创建并激活虚拟环境:
python -m venv mtg-mcp-env
source mtg-mcp-env/bin/activate  # On Windows: mtg-mcp-env\Scripts\activate
  1. 以开发模式安装该软件包:
pip install -e ".[dev]"

用法

作为MCP服务器

该服务器可以与任何MCP兼容的客户端一起使用。请在您的MCP客户端配置中添加以下内容:

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

可用工具

  • search_cards按名称搜索卡片
  • get_card_details获取特定卡片的详细信息
  • filter_cards按属性筛选卡片
  • get_sets获取MTG(万智牌)系列信息
  • get_random_cards获取随机卡片以进行探索

发展

运行测试

pytest

代码格式化

black mtg_mcp_server tests
isort mtg_mcp_server tests

类型检查

mypy mtg_mcp_server

许可证

麻省理工学院许可证