Returnolio

Returnolio MCP 服务

这是位于 https://mcp.returnolio.com/mcp 的 MCP 服务。它让 Claude、ChatGPT 和其他 MCP 客户端读取已登录用户的 Returnolio 股票研究内容：公司评分、每月 Top 10、筛选器、市场概览、事件日历，以及用户自己的关注列表和投资组合。

它已在官方 MCP Registry 中登记，名称为 com.returnolio/returnolio。

连接

在 Claude 中：依次选择 Settings › Connectors › Add custom connector，然后粘贴 https://mcp.returnolio.com/mcp。使用你的 Returnolio 账户登录。Returnolio 套餐决定哪些工具会提供响应。其他客户端的设置说明见 https://returnolio.com/docs/features/mcp

工具

所有工具都为只读工具。它们都不能进行交易、转移资金或更改你的数据。

工具	返回内容
get_stock_score	一只股票的评分及其五大支柱：质量、盈利能力、价值安全边际、动量和聪明资金
compare_stocks	并排比较多只股票
screen_stocks	符合你筛选条件的公司
search_tickers	按名称查找股票代码
get_top10	每月 Top 10
get_moonshot	Moonshot Detected 精选股票
get_market_overview	主要指数和宏观经济概况：利率、通胀、就业
get_calendar	财报、事件和 IPO
my_watchlist	你自己的关注列表
my_portfolio	你自己的投资组合，仅以数字形式呈现
get_app_link	Returnolio 应用中对应页面的链接

每个回答都会附上应用中同一视图的链接。Returnolio 是一家金融出版机构，而非投资顾问：此处的任何内容都不是买入或卖出建议。

构建方式

该服务刻意保持精简。它不保存任何数据库凭据，也不做任何产品决策。每次工具调用都会转到 Returnolio Web 应用的网关，由网关再次检查用户套餐、应用速率限制、限制结果数量并附上免责声明。

• **登录：**使用 OAuth。访问令牌由 Web 应用通过 Ed25519 私钥签名。 本服务仅持有公钥，因此可以验证令牌，但无法创建令牌。
• 网关调用会对路径、查询字符串和令牌进行签名，因此手动复制的令牌无法通过重放攻击访问网关。
• **限制：**每位用户和每个服务的活动会话数、空闲超时，以及创建会话的速率限制。所有限制都通过环境变量设置（src/config.ts）。
• **失败时关闭：**没有有效的公钥和服务密钥时，服务不会启动。 日志会记录变量名称，但绝不会记录其值。
• **日志：**每个事件记录一行 JSON。令牌和电子邮件地址会被删除或掩码处理（src/log.ts）。

自行运行

cp .env.example .env   # fill in MCP_JWT_PUBLIC_KEY and MCP_SERVICE_SECRET
npm ci
npm test               # typecheck, build and every test
npm start

如果没有 Returnolio 网关支持，该服务仍会启动，但每次工具调用都会被拒绝。 提供这些代码，是为了让你了解它如何处理登录和你的数据。

安全

如需报告漏洞，请参阅 https://returnolio.com/.well-known/security.txt