Magic: The Gathering

🚀 魔法：集會 MCP 工具服務器

這是一個用於訪問魔法：集會卡牌數據、規則和集合信息的模型上下文協議 (MCP) 服務器。它能讓你快速訪問卡牌細節、裁決信息以及綜合規則部分等內容。

🚀 快速開始

在使用這個 MCP 工具服務器之前，你需要先完成安裝和設置。以下是具體步驟：

1. 安裝要求：
   • PHP 8.1 或更高版本：你可以運行 php --version 來檢查當前版本。如果需要下載，可訪問 php.net。
   • Composer（PHP 的依賴管理工具）：從 getcomposer.org 下載。
2. 設置項目：
   • 克隆此倉庫：

git clone https://github.com/james2037/mcp-gatherer.git

- 切換到項目目錄：

cd mcp-gatherer

- 安裝依賴項：

composer install

3. 運行服務器： 你的 MCP 客戶端（例如 Claude Desktop）可以通過調用以下命令啟動服務器：

php path/to/mcp_server.php

服務器啟動後，你就可以通過 MCP 客戶端開始使用魔法：集會工具了。如有必要，請指定 STDIO 傳輸。

對於 Windows 用戶，一個示例 claude_desktop_config.json 如下：

{
  "mcpServers": {
    "mcp-gatherer": {
      "command": "php",
      "args": ["C:\\mcp-gatherer\\mcp_server.php"],
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

✨ 主要特性

• 搜索功能：可以按名稱、顏色、類型和其他標準搜索魔法卡片。
• 詳細信息查看：查看詳細的卡牌信息，包括裁決和外語版本。
• 規則訪問：訪問魔法：集會綜合規則。
• 集合瀏覽：瀏覽集合信息和卡牌列表。
• 圖像查看：若有提供，可查看卡牌圖像。

📦 安裝指南

安裝要求

1. PHP 8.1 或更高版本
   • 檢查版本方法：運行 php --version。
   • 如需下載，請訪問 php.net。
2. Composer (PHP 的依賴管理工具)
   • 下載地址：getcomposer.org。

項目設置

1. 克隆此倉庫：

git clone https://github.com/james2037/mcp-gatherer.git

2. 切換到項目目錄：

cd mcp-gatherer

3. 安裝依賴項：

composer install

💻 使用示例

啟動服務器

你的 MCP 客戶端（例如 Claude Desktop）可以通過調用以下命令啟動服務器：

php path/to/mcp_server.php

Windows 用戶配置示例

一個適用於 Windows 用戶的示例 claude_desktop_config.json 如下：

{
  "mcpServers": {
    "mcp-gatherer": {
      "command": "php",
      "args": ["C:\\mcp-gatherer\\mcp_server.php"],
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

📄 許可證

此項目根據 MIT 許可證發佈。詳細信息請參閱 LICENSE 文件。

🤝 貢獻

如果你希望為該工具的開發做出貢獻，請隨意提交問題或拉取請求。對於重大更改，請先打開一個問題來討論你想要更改的內容。