PanWatch MCP Server 实践：把 AI 盯盘助手接入 Claude 等外部 Agent 生态

PanWatch MCP Server 实践把 AI 盯盘助手接入 Claude 等外部 Agent 生态【免费下载链接】PanWatchPanWatch — AI stock monitoring for A-shares, HK US markets, powered by TradingAgents. Portfolio insights, real-time alerts automated reports.盯盘侠覆盖 A股/港股/美股的 AI 盯盘、持仓分析、实时提醒与自动报告。项目地址: https://gitcode.com/GitHub_Trending/pa/PanWatchPanWatch盯盘侠是一款覆盖 A股、港股、美股的 AI 盯盘工具内置MCP Server让你无需写任何代码就能把持仓查询、股票报价、技术面分析等能力一键接入 Claude 等支持 MCPModel Context Protocol的外部 AI Agent 生态。本文用最短路径带你完成接入并讲清楚它背后的只读安全设计。一、为什么 AI 盯盘需要 MCP Server过去想让外部 AI比如 Claude帮忙分析持仓你得手动截图、复制数据、再粘贴进对话框。MCP 的出现改变了这件事PanWatch 把自己的只读查询能力封装成标准 MCP 端点外部 Agent 可以直接长出一双眼睛实时读取你账户里的行情与持仓数据。PanWatch 的 MCP 端点是一个极简的 JSON-RPC 服务Streamable HTTP 响应模式只暴露initialize、tools/list、tools/call三个协议方法协议表面小、依赖最小实现全部集中在 src/modules/administration/api/mcp.py 一个文件里。二、MCP Server 暴露了哪些盯盘工具PanWatch 复用内置 AI 助手的公开工具定义见 src/modules/assistant/tool_adapters.py共 5 个只读工具工具名能力get_portfolio查询多账户持仓、盈亏与资金总览get_stock_quote获取单只股票的实时报价get_technical_analysis获取技术面信号与评分均线、MACD 等get_stock_suggestions获取 AI 买卖建议与 Agent 分析结论get_watchlist查询自选股/关注列表这 5 个工具就是外部 Agent 能调用到的全部能力——全只读没有写入操作天然杜绝误操作风险。三、三步完成接入创建 PAT → 配置客户端 → 对话验证1. 创建 PAT个人访问令牌PanWatch 为 MCP 端点设计了独立的 PAT 鉴权体系工具实现见 src/modules/administration/pat.py令牌以pwmcp_为前缀便于识别与审计明文只在创建时返回一次服务端只存 sha256 摘要默认 scope 为mcp:read且这是唯一允许的 scope。登录网页端后在设置页的 PAT 管理区对应 src/components/PatSection.tsx即可创建/吊销令牌也可以直接调用管理 APIsrc/modules/administration/api/pats.pyPOST /api/pats {name: claude-desktop, expires_in_days: 90}返回中的token字段就是pwmcp_开头的明文令牌请妥善保存。2. 配置你的 MCP 客户端以 Claude Desktop 的claude_desktop_config.json为例指向 PanWatch 的顶层/mcp端点即可{ mcpServers: { panwatch: { url: http://你的服务器地址:端口/mcp, headers: { Authorization: Bearer pwmcp_你的令牌 } } } }注意端点是/mcp而不是/api/mcp——它特意挂在顶层绕开普通 API 的响应包装保证 JSON-RPC 报文原样返回。3. 对话验证重启客户端后可以直接对 Claude 说看看我自选股里有哪些票、宁德时代现在什么价、技术面如何Claude 会自动调用get_watchlist、get_stock_quote、get_technical_analysis等工具把 PanWatch 里的真实数据组织成回答。四、安全设计为什么敢把数据交给外部 AgentMCP 端点的安全边界在 src/modules/administration/api/mcp.py 中体现得非常清楚鉴权分流登录用的 JWT 进不了 MCP 端点pwmcp_前缀的 PAT 也进不了普通 API两条链路互相隔离常数时间比较令牌校验使用hmac.compare_digest防时序攻击只读白名单不在白名单内的工具名直接返回 JSON-RPC 参数错误且每次调用都会落一条审计日志工具名、参数摘要、耗时、来源 IP日志保留 30 天令牌可随时吊销在设置页吊销后令牌立即失效。相关行为均有回归测试覆盖可参考 tests/test_mcp_server.py。五、典型使用场景 晨间复盘让 Claude 汇总get_portfolio的隔夜盈亏再结合get_stock_suggestions给出今日关注点个股体检把某只股票的报价 技术面信号喂给外部 Agent与 PanWatch 内置建议交叉印证多 Agent 协作多个支持 MCP 的客户端共享同一 PAT形成一个数据源、多个分析视角的工作流。六、小结PanWatch 的 MCP Server 用最小协议表面 只读工具 独立 PAT 的组合把 AI 盯盘数据能力安全地开放给了 Claude 等外部 Agent 生态。整个过程三步完成创建 PAT、填一段配置、开口提问。如果你想了解整体架构可以继续阅读 src/ARCHITECTURE.md 与 CONTRIBUTING.md动手实践前记得先给令牌设一个合理的有效期。【免费下载链接】PanWatchPanWatch — AI stock monitoring for A-shares, HK US markets, powered by TradingAgents. Portfolio insights, real-time alerts automated reports.盯盘侠覆盖 A股/港股/美股的 AI 盯盘、持仓分析、实时提醒与自动报告。项目地址: https://gitcode.com/GitHub_Trending/pa/PanWatch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考