使用说明

项目简介

Magic: The Gathering MCP Tool Server 是一个基于 Model Context Protocol (MCP) 的服务器，旨在为大型语言模型（LLM）提供访问万智牌（Magic: The Gathering）卡牌数据、规则和系列信息的接口。通过集成此服务器，LLM 可以理解和查询万智牌世界的各种信息，从而在游戏相关的应用中提供更丰富的上下文和功能。

主要功能点

卡牌检索: 支持通过名称、颜色、类型等多种条件搜索万智牌卡牌。
卡牌详情: 获取卡牌的详细信息，包括规则解释、外语版本和图片（如有）。
规则查询: 访问最新的万智牌完整规则文档内容。
系列信息: 浏览万智牌系列列表和每个系列包含的卡牌信息。

安装步骤

环境准备: 确保已安装 PHP 8.1 或更高版本，并已安装 Composer (PHP 依赖管理工具)。

下载仓库: 使用 Git 克隆仓库到本地：

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

进入目录: 导航到项目目录：
```
cd mcp-gatherer
```
安装依赖: 使用 Composer 安装项目依赖：
```
composer install
```

服务器配置

要将此 MCP 服务器与 MCP 客户端（如 Claude Desktop）配合使用，您需要在客户端中配置服务器启动信息。以下是一个 'claude_desktop_config.json' 示例配置，适用于 Windows 用户：

{
  "mcpServers": {
    "mtg-gatherer": {
      "command": "php",
      "args": ["path/to/mcp_server.php"],
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

配置参数说明:

server name: 'mtg-gatherer' (服务器名称，您可以自定义)
command: 'php' (执行 PHP 脚本的命令)
args: '["path/to/mcp_server.php"]' (服务器脚本路径，请将 'path/to/mcp_server.php' 替换为实际 'mcp_server.php' 文件的路径)

基本使用方法

启动服务器: 在 MCP 客户端中配置并启动 'mtg-gatherer' 服务器。客户端会调用配置的命令来启动服务器进程。
客户端请求: 当客户端需要万智牌相关信息时，它会向 MCP 服务器发送符合 MCP 协议的 JSON-RPC 请求。
服务器响应: MCP 服务器接收请求后，根据请求内容调用相应的工具（如卡牌搜索、规则查询等），并将结果以 JSON-RPC 响应返回给客户端。
LLM 使用: LLM 客户端可以利用这些工具获取的上下文信息，从而更好地理解和处理用户关于万智牌的query。例如，用户可以询问“最新的万智牌系列有哪些？”，LLM 可以调用 'mtg_recent_sets' 工具获取答案并返回给用户。

关键词