stockportfolio-mcp

stockportfolio-mcp

有申报文件依据的美国股票数据，供你的 Agent 使用 — 财务数据、SEC 申报文件时间线、公司比较和基金简介，每个返回值都附有其来源申报文件的 URL。缺失的数据会如实标记为缺失；不会进行估算。

# Get a key (Dev plan: $19.99/month, 200 credits) → https://stockportfolio.pro/api

安装

将以下内容添加到 MCP 客户端的配置中，然后重启客户端：

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json（macOS） 或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "stockportfolio": {
      "command": "npx",
      "args": ["-y", "stockportfolio-mcp"],
      "env": { "STOCKPORTFOLIO_API_KEY": "your-key-here" }
    }
  }
}

Cursor — ~/.cursor/mcp.json，添加相同的代码块。

然后向 Agent 提问，例如 “对 NVDA 使用 sp_financials，并显示每项数据的报告期和申报文件来源。”

需要 Node 18 或更高版本；首次运行时，npx 会获取该软件包。无需安装其他内容 — 此软件包已包含所需的一切。

工具

工具	返回内容	费用
sp_financials(ticker, tool?)	来自已申报财务报表的期间锁定数据。tool 用于选择视图：earnings-quality（默认）、dilution、buybacks-vs-dilution、revenue-consistency、profitability-trend、cash-flow-quality、free-cash-flow-trend、debt-snapshot 等。	1 个额度
sp_filing(ticker)	最新的 10-K / 10-Q / 8-K / Form 4，含日期和 EDGAR 直达链接。	1 个额度
sp_compare(tickers)	并列比较两个股票代码的数据，取自各自最新的已申报年报。各期间数据保持分开。	1 个额度
sp_screen(tickers)	按已申报的营收增长率为最多 10 个股票代码排序。	1 个额度
sp_fund(symbol)	ETF / 共同基金的费用、持仓、资产配置、业绩和风险。标注为基金数据 — 绝不会作为公司 SEC 数据呈现。	1 个额度
sp_ask(question)	基于申报文件的回答，并注明来源类别（filed / fund-data / live-web）。	4 个额度
sp_health()	存活探测：版本、工具数量。免费。	0

额度是你的密钥每月可用的调用额度（Dev 计划每月 200 个），每月 1 日重置。 即使密钥错误或额度已用完，sp_health 仍会响应，因此可以通过探测区分额度耗尽的密钥和已停止运行的服务。

响应示例

真实响应（已精简）— 这是 sp_filing("NVDA") 的结果：

{
  "tool": "filing-timeline",
  "symbol": "NVDA",
  "generatedAt": "2026-09-11T18:39:50.366Z",
  "data": {
    "tool": "filing-timeline",
    "symbol": "NVDA",
    "source": "SEC EDGAR",
    "filings": [
      {
        "form": "4",
        "label": "Form 4 (insider ownership)",
        "date": "2026-09-08",
        "url": "https://www.sec.gov/Archives/edgar/data/1045810/000119903926000014/xslF345X06/wk-form4_1788901755.xml"
      }
    ]
  },
  "source": {
    "type": "filed",
    "url": "https://www.sec.gov/Archives/edgar/data/1045810/000119903926000014/xslF345X06/wk-form4_1788901755.xml",
    "period": null,
    "note": "Informational research only — verify in the linked SEC filing. Not investment advice."
  },
  "warnings": [],
  "citation": {
    "filingSource": "https://www.sec.gov/Archives/edgar/data/1045810/000119903926000014/xslF345X06/wk-form4_1788901755.xml",
    "verifyAt": "https://www.stockportfolio.pro/stocks/NVDA?utm_source=mcp&utm_medium=integration&utm_campaign=stockportfolio-mcp",
    "poweredBy": "StockPortfolio.pro — filing-grounded US company data"
  }
}

source.url 是整个设计的核心：Agent 可以引用申报文件，而不是直接断言某个数字。如果字段没有申报文件 URL，响应会明确说明，而不会悄悄省略；warnings 会标记不完整的申报文件。

此软件包包含的内容

一个通过标准输入输出通信的 MCP 服务，代理到托管端点 https://www.stockportfolio.pro/mcp。它从标准输入读取 JSON-RPC 请求，使用你的密钥作为 bearer 标头转发每个请求，再将回复转发到标准输出。tarball 中不包含申报文件数据、模型代码或服务端逻辑 — 唯一包含的内容是你提供的密钥，而且该密钥只会发送到此端点。

由于端点是无状态的，每个客户端运行一个桥接进程即可，无需恢复会话 — 连接中断后，下次调用时会重新建立连接。

故障排查

问题	原因
The API key was rejected	STOCKPORTFOLIO_API_KEY 缺失、已撤销，或粘贴时带了引号。
Out of credits for this month	本月额度已用完。额度会在每月 1 日重置，也可以在定价页面购买额度。
Rate limited	并发调用过多；请稍后重试。
npx 找不到软件包	需要 Node 18+。在终端运行 npx -y stockportfolio-mcp，会显示与你的客户端相同的错误。
客户端未显示工具	修改配置后重启客户端 — MCP 配置会在启动时读取。

桥接进程会将错误打印到标准错误流，大多数 MCP 客户端会在日志面板中显示这些错误。要直接查看错误，请自行运行：

STOCKPORTFOLIO_API_KEY=your-key npx -y stockportfolio-mcp

链接

• 定价和密钥管理：https://stockportfolio.pro/api?utm_source=npm&utm_medium=integration&utm_campaign=stockportfolio-mcp
• REST API（相同数据，HTTP）：https://stockportfolio.pro/api/v1
• 来源和覆盖范围：https://www.stockportfolio.pro/

仅供信息研究，不构成投资建议。基金数据源自 Yahoo，不可再分发。