作 者：老余捞鱼
原创不易，转载请标明出处及原作者。
技术讨论不构成任何操作建议。
模型评测不等于投资建议。
不荐股、不卖课、不承诺收益。
市场有风险，请合法合规投资。
本文约 3100 字 | 预计阅读 9 分钟，后有安装命令和项目地址，建议先收藏
5 个工具，457 个函数，每个参数的说明都很简短，项目挂在 TradersPost 名下，一行命令就能接进各种 AI，这是 Pine MCP 给我的第一印象。
我把包解下来跑了一遍。工具全通，数据比宣传的多 18 个函数，参数说明那栏确实空着。
想写这篇，是因为讲它的都在说收录了多少，没人讲它答不上什么。往下分两半，先讲装上就能用的，再拆三处得提前知道的短板。
它到底装了什么
它做的事，是把 TradingView 官方的 Pine Script v6 手册塞进 AI 的上下文，写代码前先查，不凭记忆猜。
5 个工具，分工是这样。
| 工具 | 查什么 | 什么时候用 |
|---|---|---|
| pine_reference | 函数签名、参数、示例 | 知道名字，要核对 |
| pine_examples | 代码示例 | 想抄现成的 |
| pine_search | 全文，含手册和指南 | 只记得关键词 |
| pine_guide | 概念指南 | 想搞懂原理 |
| pine_categories | 48 个分类清单 | 不知道有哪些 |
我第一次看这五个工具名，没分清谁是谁，挨个读完描述才明白：reference 和 search 一个查准一个查全，examples 是 search 的窄化版，名字太像了。
除了工具，还有 3 个提示模板（写指标、调策略、迁移版本）和 2 个资源入口（清单、速查表）。数据全在本地，1.2MB 的压缩包，不联网。
底层做的事不复杂。Pine Script v6 的参考手册一共 4.6MB，一百多万 token，任何模型都装不下。所以它把手册切成 2822 个片段，预先算好索引，AI 问到哪段就取哪段。搜索用自写的 BM25 打分，配一张一百多条的近义词表，sma 会自动落到 ta.sma。
这个设计把它的上限定死了。能查到什么，完全取决于包里那份快照。
装完先跑自检
我装好这类开源项目的第一件事不是写代码，而是跑自检。
node dist/index.js --check
loaded 475 functions + 466 variables
loaded 2822 chunks, 919 functions indexed (475ms)
Guide topics: 82
Index tokens: 13989输出里有三个数字值得记下来。475 个函数，466 个变量，2822 个片段。
而 README 首页写着 457 个函数、427 个变量。
差 18 个函数、39 个变量。我一开始以为是自己装错了版本，把 npm 上两个包都解出来对，原因才清楚。v1.0.0 的元数据写着 457 和 427，日期停在 2025 年 8 月 16 日，解析方式是手工扒 HTML。v1.1.0 换成浏览器自动抓取，日期涨到 2026 年 3 月 5 日，数量跟着变成 475 和 466。README 里那两句话从 v1.0.0 一直留到现在，没改。
同一份 README 里 --check 的示例输出写「Functions 899」，我自己跑出来是 919。三个数字三套口径，全在一页纸上。
这种小错通常不影响使用。真正该留意的是它背后那句话，写文档的人和他最后一次核对数据的时间，隔了多久。
怎么装
一行命令。
claude mcp add pinescript -- npx -y pinescript-mcp-server前提是本机有 Node 18 以上。用 Claude Desktop 的在设置里编辑配置文件，加一段 mcpServers 就行，README 写得挺细。Cursor、Windsurf 这类支持 stdio 的工具，直接指向 npx -y pinescript-mcp-server。
国内有个坑要先处理。我第一次用默认源装，三分钟没动静，超时退出。我以为是网络的问题，换成镜像源再装，十五秒结束。
npm config set registry https://registry.npmmirror.com这是第一步，不是最后一步。装不上不是工具的问题，是源的问题。
装好之后怎么用
上面 5 个工具，日常用得上的其实只有两个。想要代码先 pine_examples，想要签名再 pine_reference。
举个例子。想让它写一套 BTC 的 EMA 交叉策略加 ATR 止损，正常会这么问。
帮我写一套 BTC 的 EMA 交叉策略，加入 ATR 止损，全部使用 Pine Script v6。
AI 会先搜示例，找到 strategy.exit 的完整用法，再查 ta.atr 和 ta.ema 的签名，最后拼代码。
我按这条路走了一遍，拿到的素材是这个样子。ta.rsi 的返回里有完整描述、函数签名、参数表、可运行示例，末尾还有 See Also 指向 ta.rma。示例代码带着原始注释，缩进是对的，能直接粘进 TradingView。
这是它最值钱的地方。收录多少条不重要，重要的是每个函数底下那段能跑的代码。1638 段 v6 代码块，全带注释。
三句可以直接抄的提问。
- 帮我写个 RSI 背离指标，先查
ta.rsi和ta.pivothigh的签名 strategy.exit的 profit 和 limit 怎么配合，给我一段完整示例- 这段 v5 代码迁移到 v6 要改哪几处
第一句让它查签名，第二句让它抄例子，第三句走迁移流程。第三句最能体现它的价值，版本差异这种事，模型凭记忆十有八九会答错。
还有个被低估的部分是那 3 个提示模板。写指标、调策略、迁移版本，各一套固定流程。Claude Code 里直接打名字就能调起来。
写指标那个模板会按顺序问清四件事，用哪个周期、指标画在主图还是副图、输入参数有哪些、信号怎么算。问完再动手。
调试那个更实用，给的是一张排查清单。先看是不是重绘，再看 request.security 有没有用未来数据，然后才是逻辑本身。这个顺序很多人是反的，一上来就盯着信号条件看，其实前面两关就错了。
这套东西的价值在于，它把老手的排查习惯写成了流程。migrate_script 那个模板的作用反而不大，因为迁移这件事它数据里的指南已经写得够细。
— · —
以上是装上就能用的部分。往下是我量的三处短板，也是这篇真正想说的。
参数那一栏，是空的
ta.rsi 的返回长这样。
## Parameters- source (series int/float)- length (simple int)只有名字和类型，没有一句说明。
ta.rsi 简单，看得出 length 是周期。换成 strategy.exit 就麻烦了。这个函数有 21 个参数。我盯着那几行找说明，返回的只有名字加类型，profit、limit、loss、stop、trail_price、trail_points、trail_offset，一路排到 disable_alert。
哪个是什么意思，一个都没说。
profit 和 limit 都是止盈，这两个搞混，回测结果能差出多少？trail_price 和 trail_points 又能不能同时传？这些是写策略时最常卡住的地方，它答不上来。
我去翻了源码，原因就在几十行里。格式化参数的那个函数只做一件事，输出名字和类型，数据里的 description 字段根本没被拼进去。
再翻原始数据。1231 个参数，1045 个的描述不超过 8 个字符。其中 296 个就一个单词「The」，129 个是「A」，56 个是「An」。ta.sma 的 source 参数，描述是「Series」，length 是「Number」。
抓取的时候按句号或空格切断了。原句大概是「Series of values to process」，抓完只剩开头一个词。
同一个问题在两个版本里都在。v1.0.0 手工解析 HTML，86.7% 的参数描述残缺；v1.1.0 换成浏览器抓取，还是 84.9%。换工具没用，因为病根不在抓取方式，在页面结构本身。
作者显然知道这事。源码里有一行注释，说 JSON 里的示例缺换行，所以宁可不用它，改从 markdown 取。示例的问题他绕过去了，参数说明没绕，干脆不输出。
后果很直接。AI 现在能看到 strategy.exit 有哪 21 个参数，签名一个不差，但不知道每个参数管什么。函数名不会再编了，参数含义照样能编。
说实话，函数名写错顶多报个编译错误，一眼能修。参数含义写错是能跑通的错，回测曲线照画，数字全错。
一次调用，12 万字符
第二个短板更隐蔽。
pine_guide 用来读概念指南，比如执行模型、策略机制、多周期数据。我拿「execution model」问了一次，返回 121602 个字符。
看到这个数字我第一反应是脚本卡住重复输出了，扫了眼结尾才发现没有，就是一个主题下的全部内容。
对照其他三个工具。查 ta.rsi 737 字符，搜「stop loss」2563 字符，找止损示例 2090 字符。
差了两个数量级。
12 万字符大概 3 万 token。一次调用就能吃掉小半个上下文窗口。
代码也一样，这个工具把匹配到的主题下所有片段拼起来直接返回，没有任何长度上限，参数表里也没有 limit 这一项。别的工具都做了截断。pine_search 每条结果限 800 字符。pine_reference 提供 format: signature，只取签名省 token。说明作者在意成本。偏偏指南这条路径漏了。
一个宣称「省下翻文档时间」的工具，把检索做成了全量灌入，有点讽刺。
所以 pine_guide 我建议直接不用。真要读概念，自己去 TradingView 打开那一页，看完把相关段落贴给 AI，比让它一次吞 12 万字符可控得多。
停在三月的快照
第三个问题最要紧，因为它不会报错。
GitHub 上这个仓库一共 6 个提交，全在 2026 年 3 月 5 日那一天。从建库到发版，一天走完。
之后到今天，零提交。
npm 上只有两个版本，1.0.0 和 1.1.0，也都在 3 月 5 日。star 29，fork 15，没有一个开着的 issue。
包里的数据元数据写着抓取时间 2026 年 3 月 5 日 21 点 35 分。里面最新的一条官方更新日志，停在 2026 年 1 月。
到今天，快 8 个月。
Pine Script 的核心 API 很稳，8 个月前的 ta.sma 现在照样能用，这部分不用操心。风险在另一头。这 8 个月里 TradingView 新加的函数、新改的参数，它一个都不知道。更麻烦的是，AI 拿到这份快照会当成最新的，它不知道自己的知识停在哪一天，也就不会告诉你：这个函数我没见过。
这是所有「把文档塞给 AI」的工具共有的毛病。文档有保质期，工具不会主动报过期。
但话说回来，快照本身不是随便扒的。分类列表里 strategy 收了 96 条，是最全的一块。ta 67 条，array 56 条，matrix 50 条。2026 年 1 月才上线的 Footprint 功能也有。9 个函数带全套示例，都在。
问题不在抓取质量，在没人续。更新流水线其实是写好的，仓库里有 GitHub Actions 定时抓取，还有 puppeteer 脚本直奔 TradingView 官方页面。跑一次就能把数据拉新。
没跑。
所以它该怎么用
三句话。
查签名和抄例子，它够用。 475 个函数、2822 个片段、1638 段带注释的 v6 示例，免费，一行命令。这部分比我预期的好，示例代码的质量明显高于模型自己背出来的。
别指望它讲参数。 复杂函数只给名字和类型，21 个参数一个说明都没有。碰到 strategy.exit、request.security 这种参数多的，还是得自己去官方文档确认一遍。
别用 pine_guide 拉整篇。 一次 12 万字符，得不偿失。
有个地方我说不好。装了它之后，AI 写出来的代码正确率到底提高多少，我给不出数字，因为没有接 Claude Code 做端到端对照。只能说素材质量这一层是扎实的，拼代码那一步还得自己盯。
如果想再稳一点，有个土办法。装完先让 AI 查一个自己最熟的函数，比如 ta.rsi。看它返回的参数表是空是满，那一眼就知道这份快照值多少。
回到开头那两个数字。457 是它自己宣传的，实际有 475，差的这 18 个只是没来得及改。参数说明空着，才是真该补的地方。
一个能查到签名、查不到参数的手册，能让 AI 少编函数名，但拦不住它编参数含义。装上它，AI 从「凭记忆写」变成「照着签名写」，中间那一步还是得人来。
判断一个工具值不值得留，不看它宣传了多少条，看它缺的那块是不是正好卡在必经路上。
对我来说，签名和例子就在必经路上，参数说明绕一下能接受。所以留着，只留 pine_reference 和 pine_examples 这两个。我更倾向把它当速查表用，不当教科书。
— · —
参考链接
- 项目仓库 https://github.com/TradersPost/pine-mcp
- npm 包 https://www.npmjs.com/package/pinescript-mcp-server
- Pine Script v6 官方参考手册 https://www.tradingview.com/pine-script-reference/v6/
#PineScript #TradingView #MCP #ClaudeCode #AI工具实测 #开源量化 #指标开发 #策略开发 #量化平权
Be First to Comment