使用说明（Markdown 格式）：

• 项目简介
  • CardForge MCP Server 是一个基于 MCP（Model Context Protocol）协议的后端服务，旨在通过 JSON-RPC 与 Claude Desktop 等 MCP 客户端进行交互。它暴露一组工具、资源和提示模板，允许 LLM 客户端读取卡片资源、执行外部工具、并渲染和获取对话模板，从而为 AI 助手提供 MTG 收藏管理、牌组分析、买入/卖出清单等上下文能力。
• 主要功能点
  • 提供并注册多种 Tools（如 search_cards、check_ownership、get_collection_stats、get_deck_missing_cards、add_to_buy_list、find_duplicates、compare_printings 等），LLM 通过工具调用执行外部功能。
  • 提供 Resources，用于向 LLM 客户端提供可访问的数据源或上下文信息。
  • 提供 Prompts/模板，支持可定制的 LLM 交互模式，便于对话中引导生成和操作。
  • 通过 JSON-RPC 与客户端通信，支持会话管理与能力声明。
  • 内置基础服务器入口，支持通过标准入口直接启动，且与 Claude Desktop 的配置配合使用。
  • 依赖 CardForge 的服务层实现（CardService、CollectionService、DeckService、TradeService、PricingService），实现对数据、卡牌、购买/出售等功能的对接。
• 安装步骤
  • 环境要求：Python 3.11 及以上
  • 获取代码并进入项目根目录
  • 安装依赖（在项目根目录执行）：pip install -r requirements.txt
  • 启动 MCP 服务器：
    • 直接运行模块：python -m cardforge.mcp.server
    • 运行后服务器将监听 Claude Desktop 的请求，等待 MCP 客户端连接
• 服务器配置（给 MCP 客户端的配置示例，JSON 格式，含 server 名称、启动命令及参数）
  • server_name: cardforge
  • command: python
  • args: ["-m", "cardforge.mcp.server"]
  • cwd: "<你的项目根路径>/CardForge"（请替换为实际的项目根目录路径） 注释说明：
  • server_name 用于在 Claude Desktop 的配置中标识该 MCP 服务器实例。
  • command 与 args 组合指定了如何启动服务器进程（通过 Python 模块直接执行）。
  • cwd 指定了服务器运行时工作目录，通常为项目根目录，确保能够正确访问代码和资源。
• 基本使用方法
  • 启动后，MCP 客户端（如 Claude Desktop）将自动检测并连接到 CardForge 的 MCP 服务器。
  • 在 Claude Desktop 中启用或禁用相应的 Tools、Resources 和 Prompts，LLM 将通过 JSON-RPC 请求调用服务器提供的能力。
  • 使用示例：使用 search_cards、get_collection_stats、get_deck_missing_cards 等工具查询和分析 MTG 收藏数据，服务器返回标准的 JSON-RPC 响应。
  • 如需查看服务器的帮助或工具列表，请在 Claude Desktop 的 MCP 配置中查看 CardForge 提供的工具及其输入输出描述。