美股喊单核查助手 · 小白安装指南 / Beginner Setup Guide

仅供研究学习,不是投资建议。 这里给出的所有结果(谁喊单准、评分、情绪等)都只是帮你做判断的参考信号,绝不是叫你买或卖。数据可能延迟、不全甚至出错。

这是个啥?先打个比方 / What is this

你平时是不是会在 AI 助手(就是那种能聊天的智能助手)里问问题?

这个东西,就是给你的 AI 助手装一个「美股喊单核查」插件。

装好以后,你就能用大白话直接问它,比如「网上那个天天喊 NVDA 的大V,他过去到底准不准?」——AI 会自己跑去查公开数据(谁喊过、喊完股票涨了还是跌了、对比大盘 SPY 准不准),然后回你一段人话总结。

你不需要懂代码,不需要会编程。

🎉 公网端点已上线,直接可用: https://mcp.koalcheck.com/mcp —— 接入不用装 Python、不用下载仓库、不用任何密钥,免费功能匿名直接用。最省事是连这行地址都不用碰:把下面【方法一】的提示词整段复制粘给你的 AI,让它替你装好。

注意 / Note: 大部分功能(SEC 内部人、做空、散户情绪、喊单战绩等)免费、无需密钥、匿名可用;只有「实时抓某大V最新推文」才需要付费 X 账号。第一次玩完全可以不填任何密钥。

🌐 别搞混: koalcheck.com 是网站(看榜单/案例);https://mcp.koalcheck.com/mcp 是给 AI 客户端的插件地址——加进 AI 里的是带 /mcp 的那一行。

【方法一 · 最简单,首推】让你的 AI 自己帮你装(粘这段 prompt)⭐⭐⭐

小白首选,字面意义上的「复制 → 粘贴 → 发送」。 你本来就在用一个 AI 了——那就让它替你干活:你不用知道 URL 要粘哪、不用懂任何配置。只要把下面这一整段提示词复制下来,粘进你的 AI 对话框发出去,它就会自己把插件装好(或者一步步教你)。

怎么用(三步):

复制下面整段提示词(从「你好」到最后一行,一字不漏)。
粘进你正在用的 AI 的对话框(Cursor / Cline / Claude Code / Cherry Studio / 网页版助手……都行),发送。
照它说的做。 能直接改你电脑配置的 AI(如 Cursor / Cline / Claude Code)会自己装好;只能聊天的 AI 会一步步告诉你「粘什么、粘哪」,你跟着做即可。

📷 [截图:用户把下面整段提示词粘进 AI 对话框,AI 开始回复「我来帮你配置 stock-picker MCP…」]

你好,我想给你(我正在用的这个 AI)接一个叫 stock-picker 的 MCP server(美股喊单核查 / 美股研究工具)。
请你帮我完成配置,全程用中文跟我沟通。我是小白,什么都不懂,请你来主导。

【目标】
把名为 "stock-picker" 的 MCP server 加进「我当前正在用的这个客户端」的 MCP 配置里。
请用「远程 HTTP(streamable-http)」方式接入下面这个公网地址——这是最简单的路,
不需要在我电脑上安装任何东西、不需要下载任何仓库、不需要任何密钥(匿名即可用免费功能):

  远程 URL:https://mcp.koalcheck.com/mcp
  传输方式 / transport:streamable-http(HTTP;若客户端只有 sse 选项,用 sse 也行)
  鉴权 / auth:无 / 匿名(不要填 X-Api-Key 或任何 header)

【请你先判断自己是哪种 AI,然后照对应方式落地】
1) 如果你能直接读写我电脑上的文件 / 能执行命令(例如 Cursor / Cline / Claude Code / Windsurf / Zed):
   请你直接帮我把配置改好,不要让我手动抄。不同客户端字段不同,例如:
     - Cursor:在 ~/.cursor/mcp.json 的 mcpServers 里用 "url": "https://mcp.koalcheck.com/mcp"
     - Claude Code:执行 `claude mcp add --transport http stock-picker https://mcp.koalcheck.com/mcp`
     - Windsurf:用 "serverUrl": "https://mcp.koalcheck.com/mcp"
     - Cline:在 MCP 设置面板里添加一个 Remote / Streamable HTTP 服务器,URL 填上面那行
   请你自己确认本客户端的正确写法再落地。
2) 如果你不能直接改我的文件(例如纯聊天的网页助手 / Cherry Studio / ChatWise / 部分桌面助手):
   就一步一步、每次只给我一步,手把手教我自己加。带我找到该客户端「添加 MCP 服务器 / Add MCP Server」
   的入口,类型选「远程 / Streamable HTTP(或 SSE)」,名称填 stock-picker,
   URL 填 https://mcp.koalcheck.com/mcp,鉴权 / Headers 留空。把每个框该填什么都告诉我。

【做完后请验证,并给我例子】
1. 让我按需重启 / 重新加载这个客户端,使 MCP 生效。
2. 调用这个 server 的 `health` 工具,确认它返回健康/可用;
   如果 health 报降级或 503,告诉我这通常不影响免费功能,并给下一步建议。
3. 验证通过后,用中文告诉我装好了,并给我 3 个可以直接问的例子,比如:
   - "@unusual_whales 最近在聊 NVDA 吗?他过去喊单到底准不准?"
   - "NVDA 综合各方信号现在偏多还是偏空?给我打个分。"
   - "苹果(AAPL)最近公司内部高管在买还是在卖自己的股票?"

【沟通要求】
- 全程用中文,把我当完全不懂技术的小白。
- 只用上面的远程 URL,不需要我装任何 Python、不需要任何仓库、不需要任何 key——别问我要这些。
- 你能直接编辑配置就直接做;否则就告诉我粘什么、粘哪,一步一步来。
- 如果我问某个大V它回"没数据",这是正常的:先让我问一句"@某某 最近在说什么"让它先抓一次推文,再问"他准不准"。

📷 [截图:AI 改好配置(填入远程 URL)后,调用 health 工具返回 ok,并回复「stock-picker 已装好,你可以这样问…」]

小提示 / Tip: 这一段提示词对能改文件的编程 AI(Cursor / Cline / Claude Code / Windsurf / Zed)和只能聊天的助手(Cherry Studio / ChatWise / 网页版助手)都管用——它会自己判断属于哪种,再决定是直接帮你装还是手把手教你。拿不准用什么 AI?先随手发给你手边那个,让它自己判断就行。

【方法二 · 手动加远程 URL】把一行地址粘进客户端 ⭐⭐

如果你愿意自己动手(或想搞清楚到底改了啥),也可以手动把这行地址加进客户端——同样不用装 Python、不用仓库、不用 key:
https://mcp.koalcheck.com/mcp
免费功能 匿名直接可用。下面按客户端给你具体怎么加。

📷 [截图:用户把 https://mcp.koalcheck.com/mcp 粘进某个 AI 客户端的「添加 MCP 服务器」输入框,点确定后状态变绿]

A. Cursor(AI 代码编辑器)

进 Settings → Tools & MCP → New MCP Server(或直接改全局 ~/.cursor/mcp.json / 项目级 .cursor/mcp.json)。

📷 [截图:Cursor 设置里 Tools & MCP 页面,点 New MCP Server]

填入远程地址(键名 mcpServers,用 url 字段):

{
  "mcpServers": {
    "stock-picker": {
      "url": "https://mcp.koalcheck.com/mcp"
    }
  }
}

保存,在 MCP 列表里看到 stock-picker 变绿/已连接即可。不用填 key、不用装 Python。

小注意: Cursor 所有 MCP 服务器工具总数上限约 40 个;Stock-Picker 有 24 个工具,单独装没问题,别和一堆别的服务器堆在一起。

B. Cline(VS Code 插件)

打开 Cline 的 MCP 设置面板(MCP Servers → Remote Servers → Add 或编辑它的 MCP 配置)。
添加一个远程服务器:
- 名称 / name:stock-picker
- 类型 / type:Streamable HTTP(远程)
- URL:https://mcp.koalcheck.com/mcp
保存、连接,看到工具加载成功即可。匿名直连,无需 key。

📷 [截图:Cline 的 Remote MCP Servers 列表里 stock-picker 已连接,显示已加载的工具]

C. Cherry Studio(国产,大陆首推 ⭐)

开源、跨平台、全中文界面,内置 DeepSeek/通义等国产模型——大陆用户首选这个。 纯 UI 操作,不用手写 JSON。

进 设置 → MCP 服务器 → 添加服务器。

📷 [截图:Cherry Studio 添加 MCP 服务器对话框,类型下拉里有 STDIO / SSE / Streamable HTTP]
类型选 Streamable HTTP(可流式 HTTP),按下面填:
- 名称:stock-picker
- URL / 地址:https://mcp.koalcheck.com/mcp
- 鉴权 / Headers:留空(匿名免费用)
保存、启用,看到工具加载成功即可。不用装本地命令,不用 key。

📷 [截图:Cherry Studio 里 stock-picker 已启用(Streamable HTTP),显示已加载的工具数]

D. Claude Code(官方 CLI,命令行一条搞定)

终端里执行(无需手写 JSON,--transport http 指明走远程):

# 远程 HTTP(推荐,匿名免费用)
claude mcp add --transport http stock-picker https://mcp.koalcheck.com/mcp

# 查看 / 删除
claude mcp list
claude mcp get stock-picker
claude mcp remove stock-picker

📷 [截图:终端里 claude mcp add --transport http 成功,claude mcp list 显示 stock-picker 已连接]

E. Windsurf(AI 代码编辑器)

进 Settings → Cascade → MCP Servers → Add Server,或直接编辑它的 mcp_config.json。

用 serverUrl 字段填远程地址:

{
  "mcpServers": {
    "stock-picker": {
      "serverUrl": "https://mcp.koalcheck.com/mcp"
    }
  }
}

保存、刷新 MCP 列表,看到 stock-picker 已连接即可。匿名直连,无需 key。

📷 [截图:Windsurf 的 MCP Servers 列表里 stock-picker 已连接]

想用别的客户端?(ChatWise / 其它支持「远程 MCP / HTTP URL」的)思路都一样:找到「添加 MCP 服务器」,类型选 远程 / Streamable HTTP,URL 填 https://mcp.koalcheck.com/mcp,鉴权留空。拿不准就直接回到上面【方法一】,把那段提示词丢给你的 AI,让它自己按自己的格式装。

【方法三 · 仅限自己部署 / 有仓库访问权限的人】本地 STDIO 安装

⚠️ 这条路普通用户用不了,请直接用上面的【方法一】/【方法二】远程 URL,不需要仓库。

本地 stdio 方式需要先克隆(clone)本项目仓库,而本仓库是私有的,公众无法克隆——所以这条路只面向仓库所有者 / 自己部署(self-host)的人 / 有仓库访问权限的开发者。

只有同时满足下面条件才走这条:① 你有本仓库的访问权限、能把它 clone 到本地;② 你想离线跑、或想用自己的爬虫数据 / 改代码。不符合就回【方法一】,粘 prompt 让 AI 用远程 URL 给你装,1 分钟搞定,完全不需要仓库。

前置(仅限有仓库的人): 先 clone 仓库并在根目录装好插件程序。打开终端,执行 cd ~/stock-picker-mcp && uv sync(找不到 uv 就用 cd ~/stock-picker-mcp && pip install -e .),不报红色大错就成。装完后命令 stock-picker-mcp 就能用了。

客户端速查表 / Which client?

客户端	远程 URL(粘地址即用)	本地 stdio	怎么加	配置位置 / 键名	大陆友好
Cursor(AI 代码编辑器)	✅ 首选	✅	UI 或改 JSON	`~/.cursor/mcp.json` · 键 `mcpServers`(`url` 字段;工具上限~40)	一般
Cline(VS Code 插件)	✅ 首选	✅	MCP 设置面板	Remote Servers → Streamable HTTP	一般
Cherry Studio(国产 ⭐)	✅ 首选	✅	纯 UI,无需写 JSON	设置→MCP 服务器→添加(选 Streamable HTTP)	最友好
Claude Code(官方 CLI)	✅ 首选	✅	一条命令	`claude mcp add --transport http …`	一般
Windsurf(AI 编辑器)	✅ 首选	✅	UI 或改 JSON	`serverUrl` 字段	一般
Claude Desktop(官方桌面端)	视版本而定	✅	改 JSON 文件	`claude_desktop_config.json` · 键 `mcpServers`	一般

公众请注意: 上表「本地 stdio」一列需要本仓库(私有,公众拿不到),所以不是给你的——请走【方法一】(粘 prompt 让 AI 装)或【方法二】(手动加远程 URL)的远程方式,不需要仓库。下面这张速查表只为有仓库访问权限、自己部署的人列出本地 stdio 写法。

A. Claude Desktop(官方桌面 AI 助手 · 本地 stdio)

没装就去 claude.ai/download 下载安装(像装普通软件一样)。
打开配置文件(macOS;终端粘这行,文件不存在会顺手新建):
```
open -a TextEdit ~/Library/Application\ Support/Claude/claude_desktop_config.json
```
📷 [截图:弹出 TextEdit 白色窗口,可能是空的,也可能已有几行带大括号的内容]

把下面这段粘进去(空文件→整段粘;已有内容→只把 "stock-picker": { ... } 加进已有 "mcpServers" 大括号里,用逗号隔开):

{
  "mcpServers": {
    "stock-picker": {
      "command": "stock-picker-mcp",
      "args": [],
      "env": {
        "TWITTER_PRIMARY": "auto",
        "TWITTERAPIIO_KEY": "",
        "SEC_USER_AGENT": "my-research [email protected]"
      }
    }
  }
}

把 [email protected] 换成你自己的邮箱;TWITTERAPIIO_KEY 留空 "" 即可。

Command + S 保存,然后彻底退出(Command + Q)再重开 Claude Desktop。

📷 [截图:重开后的 Claude Desktop,输入框旁出现工具/插件图标,表示 stock-picker 已接上]

B. 其它客户端走本地 stdio

Cursor / Cline / Cherry Studio / Claude Code / Windsurf 等,如果你确实想走本地命令(而不是远程 URL),把对应配置里的「远程 URL」换成本地 stdio 写法即可:

Cursor / Windsurf(改 JSON): 把 "url" / "serverUrl" 那行换成

"command": "stock-picker-mcp",
"args": [],
"env": { "TWITTER_PRIMARY": "auto", "TWITTERAPIIO_KEY": "", "SEC_USER_AGENT": "my-research 你的邮箱" }

Cherry Studio(纯 UI): 添加服务器时类型改选 STDIO(本地命令),命令填 stock-picker-mcp,环境变量按上面填。
Claude Code(命令行): claude mcp add stock-picker stock-picker-mcp(不加 --transport http 就是本地 stdio)。

📷 [截图:某客户端里 stock-picker 以本地 stdio 方式连接成功,显示已加载的工具数]

再次提醒: 本地 stdio 只对有本仓库访问权限的人有意义(公众用不了私有仓库)。公众想用别的客户端(ChatWise / Zed …),最省事的办法仍是回到【方法一】,把那段提示词丢给该客户端,让它自己用远程 URL按自己的格式装——不需要任何仓库。各家字段不一样(Windsurf 用 serverUrl、Zed 用 context_servers 且远程需 mcp-remote 桥接),AI 自己最清楚。

装好之后能问它啥 / What to ask

在客户端的聊天框里,直接用大白话问(随便挑一句):

"帮我看看 @unusual_whales 最近在聊 NVDA 吗?他过去喊单到底准不准?"
"NVDA 这只股票,综合各方信号现在是偏多还是偏空?给我打个分。"
"苹果(AAPL)最近公司内部高管在买还是在卖自己的股票?"
"现在散户在 Reddit、StockTwits 上最热议的是哪几只票?"

它会自己调用插件去查公开数据,再用人话回你。第一次问某个大V时,它可能要先「抓一下他的推文」,稍等几秒是正常的。

📷 [截图:AI 回复里出现「正在调用 stock-picker 工具…」,然后给出一段带数据的中文总结]

🎉 到这一步,你就装好了!

如果不成 / 常见问题 (FAQ)

Q1:装完没反应,问它它说不知道、也没看到插件图标。 先确认你加对了地址:远程方式要填 https://mcp.koalcheck.com/mcp(带 /mcp)。走本地 stdio 的话,多半是配置文件没存好或位置不对——重新检查那段配置,确认最外层只有一对 { }、没有多余逗号,保存后彻底退出再重开客户端。最省事:用【方法一】的话,直接告诉你的 AI「装好了但客户端里看不到 stock-picker」,让它帮你查。

Q2:远程 URL 加进去连不上 / 一直转圈。 先确认网络能访问 https://mcp.koalcheck.com/mcp(这是个 MCP 端点,用浏览器直接打开会显示报错或空白,这是正常的,它不是给浏览器看的)。再确认客户端的「传输类型」选的是 Streamable HTTP(部分客户端叫 HTTP / SSE 也行),鉴权/Header 留空(匿名免费用,别误填 key)。还不行就把【方法一】那段提示词丢给你的 AI,让它换个传输类型(HTTP / SSE)再试。(本地 stdio 兜底只对有本仓库访问权限的人可用——见【方法三】。)

Q3:它说找不到 stock-picker-mcp 这个命令 / 启动失败。 这是本地 stdio(【方法三】,仅限有仓库的人)才会遇到的问题(远程 URL 不需要这个命令)。说明插件程序没在「默认路径」上。把配置里的:

      "command": "stock-picker-mcp",
      "args": [],

换成「指明完整路径」的写法(把 <你的用户名> 换成你电脑的用户名):

      "command": "/Users/<你的用户名>/stock-picker-mcp/.venv/bin/python",
      "args": ["-m", "stock_picker_mcp.server"],

保存,重启,再试。或者更省事:直接改用远程 URL(【方法一】粘 prompt 让 AI 装,或【方法二】手动加),根本不需要这个命令,这个问题就绕过去了。

Q4:问某个大V,它回「没数据 / no data」。 这是正常的!插件得先去抓一次这个大V的推文,才能评他的战绩。你只要先问一句「@某某最近在说什么」,等它抓完,再问「他准不准」就有数据了。

Q5:配置文件里本来就有别的内容,我怕弄坏。 对,别整段覆盖。你只需要把 "stock-picker": { ... } 这一块,加进已有的 "mcpServers": { } 大括号里面(和已有插件用逗号隔开)。拿不准的话,先把原文件复制一份备份,改坏了能还原。

Q6:我不想装环境、也没有仓库,能用吗? 能,这正是给你的路:https://mcp.koalcheck.com/mcp 已上线、匿名免费。走【方法一】让 AI 替你装,或【方法二】手动加这行 URL——都不需要仓库或 Python。(需要仓库的只有【方法三】本地 stdio,给自己部署的人。)

Q7:ChatGPT 能用吗? ChatGPT 的消费级 App 暂时没有「让你自己加任意第三方 MCP 服务器」的通用入口,所以暂不建议走 ChatGPT 这条路。请优先用上面列出、支持远程/本地 MCP 的客户端(Cursor / Cline / Cherry Studio / Claude Code / Windsurf / Claude Desktop 等)。

安全声明 / Disclaimer

这是研究和学习用的工具,不是投资建议,不是叫你买卖任何股票,也不是任何劝诱。 所有输出(战绩、评分、筛选、情绪、内部人/做空/财报数据)都只是帮你自己做判断的参考信号。数据来自第三方(X、StockTwits、Reddit、SEC、FINRA),可能延迟、不全或出错;战绩是相对大盘 SPY 的「事后统计」,过去准不代表将来准。 做任何投资决定前,请自己做功课,并咨询有牌照的专业人士。使用风险自负,不作任何担保。

MCP user guide