使用说明内容（Markdown格式）

• 项目简介

  • Polymarket MCP 服务器是一个实现 MCP（Model Context Protocol）的后端服务，围绕资源管理、工具注册/执行以及提示模板渲染，为大语言模型客户端提供结构化、可扩展的上下文服务。服务器通过 JSON-RPC 与客户端通信，支持资源访问、工具调用、以及渲染 prompts 等能力，并内部管理会话、认证、以及安全策略。

• 主要功能点

  • MCP 核心处理：实现 MCP 的核心接口，包括读取资源、列出工具、执行工具、以及工具返回的结果格式（JSON-RPC 风格的文本内容）。
  • 资源与工具托管：提供对 Resources、Tools 的注册、管理与查询，便于 LLM 客户端获取可用资源与可执行的工具集合。
  • 安全与会话管理：内置安全限额（Safety Limits）、速率限制（Rate Limiter）和会话/认证状态，确保调用行为安全可控。
  • Prompts 定义与渲染：支持通过工具和服务渲染/生成提示模板，配合 LLM 的交互模式。
  • 多传输协议与显示：默认通过标准输入/输出的 MCP 通信（stdio 传输），并具备扩展能力对接其他传输方式（如 WebSocket、SSE、StdIo 等）。
  • 服务器端运行与集成：核心服务代码在 server.py，提供启动、初始化、以及与 Claude Desktop 的集成支持（通过 Setup Wizard 提供示例配置）。

• 安装步骤

  • 获取源码：从仓库克隆或下载源码。
  • 安装依赖：使用 Python 虚拟环境安装项目所需依赖（通常通过阅读 pyproject.toml/setup 配置安装）。
  • 配置环境：创建 .env 文件，按照配置项填写 POLYGON_PRIVATE_KEY、POLYGON_ADDRESS、POLYMARKET_CHAIN_ID、POLYMARKET_API_KEY、POLYMARKET_PASSPHRASE 等环境变量（服务器会从 .env 读取配置信息）。
  • 启动 MCP 服务器：在项目根目录运行命令 python3 -m polymarket_mcp.server（或等效的启动命令），服务器将以 stdio 传输模式接收 JSON-RPC 请求并返回响应。
  • Claude Desktop 集成（可选）：通过 Setup Wizard 生成 Claude Desktop 的配置文件，配置 MCP 服务器的启动命令与参数，使 Claude 能通过 MCP 调用服务器提供的工具与资源。

• 服务器配置（MCP 客户端需要的配置片段，JSON 描述，不是代码） { "server_name": "polymarket-mcp-server", "command": "python3", "args": ["-m", "polymarket_mcp.server"] } 注解：server_name 表示 MCP 服务器的唯一名称，command 是启动服务器的可执行程序，args 为启动参数。MCP 客户端需要此信息来启动并连接到 MCP 服务器；实际运行时还需在客户端环境中提供相应的环境变量（如 .env）以实现认证和访问控制。

• 基本使用方法

  • 启动后，客户端（如 Claude Desktop）通过 MCP 的 JSON-RPC 通道与服务器通信，调用读取资源、执行工具、获取 Prompts 等。
  • 客户端可通过资源端点(polymarket://...) 获取服务器状态、配置信息等只读数据；通过 call_tool 调用注册的工具来完成市场发现、分析、交易等场景（示例工具集覆盖市场发现、市场分析、交易和实时数据等）。
  • 通过配置和工具组合，LLM 客户端能够在对话中获得市场信息、价格、深度、流动性等上下文辅助做出决策。

• 备注

  • MCP 服务器在代码层面实现了使用 mcp.server 的接口，提供 list_tools、list_resources、read_resource、call_tool 等关键接口，以及初始化和运行流程，且还集成了 WebSocket 实时数据工具与 GUI 管理界面（FastAPI Web Dashboard）。
  • 若要在生产环境中运行，请确保 .env 文件正确配置所需的密钥与 API 凭据，并按需启用/禁用只读模式或完整模式（通过环境变量和配置决定）。