mcpField
F
fmp

fmp

本地服务
houtini.com金融数据24 天前更新

关于 fmp

fmp 是面向金融研究者和投资者的 MCP 服务,可通过 Financial Modeling Prep 获取行情与公司数据,涵盖报价、财报、分析师信息和经济指标。

主要功能

  1. 01实时股票报价与代码搜索
  2. 02公司资料与财务报表
  3. 03市场涨跌榜及行业数据
  4. 04分析师预测、目标价与评级
  5. 05内部交易及机构持仓
  6. 06技术指标与历史图表

适用场景

  1. 01查看公司的财务报表
  2. 02查询实时报价和市场动态
  3. 03比较分析师预测与目标价
  4. 04检查股票代码的技术指标

MCP 相关

它将 Financial Modeling Prep API 数据作为工具提供给 MCP 客户端,包括 Claude Desktop 和 Claude Code。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"houtini-ai-fmp": {
"command": "npx",
"args": [
"-y",
"@houtini/fmp-mcp"
],
"env": {
"FMP_API_KEY": "<FMP_API_KEY>"
}
}
}
}
启动命令npx -y @houtini/fmp-mcp
需要配置的环境变量
FMP_API_KEY密钥Financial Modeling Prep API key (get from https://site.financialmodelingprep.com/developer/docs)

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@houtini/fmp-mcp1.1.9

工具

26

收录的工具列表 · 更新于 2 周前

参数类型必填说明
symbolstring是股票代码(例如:AAPL)

详细介绍

Financial Modeling Prep MCP 服务

npm version MCP Registry License: MIT Socket Badge

提供 Financial Modeling Prep 全面金融数据 API 访问能力的 Model Context Protocol(MCP)服务。直接在 Claude Desktop 中获取实时股票报价、公司基本面、财务报表、市场动态、分析师数据和技术指标。

Financial Modeling Prep MCP 服务

快速导航

功能 | 安装 | 工具 | 使用示例 | API 速率限制 | 开发 | 故障排除

功能

  • 实时市场数据:实时股票报价,包含价格、交易量和市场指标
  • 公司信息:详细的公司简介,包含行业、板块和主要高管信息
  • 财务报表:损益表、资产负债表和现金流量表
  • 市场表现:跟踪涨幅榜、跌幅榜、交易最活跃股票和板块表现
  • 分析师数据:目标价、预估、评级以及评级上调/下调信息
  • 内部交易:监控内部交易和机构持仓
  • 技术指标:RSI、SMA、EMA,支持多个时间范围
  • 经济数据:GDP、失业率、通胀、国债利率和经济日历
  • 历史图表:提供从 1 分钟到 4 小时区间的日内数据
  • 代码搜索:按名称或股票代码搜索全球交易所的公司

安装

先决条件
使用 NPX 快速开始

添加到 Claude Desktop 配置文件:

macOS:~/Library/Application Support/Claude/claude_desktop_config.json
Windows:%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "financial-modeling-prep": {
      "command": "npx",
      "args": [
        "-y",
        "@houtini/fmp-mcp"
      ],
      "env": {
        "FMP_API_KEY": "your_api_key_here"
      }
    }
  }
}

将 your_api_key_here 替换为你的 Financial Modeling Prep API 密钥。

重要:更新配置后,请完全重启 Claude Desktop。

Claude Code(CLI)

Claude Code 使用不同的注册机制——它不会读取 claude_desktop_config.json。请改用 claude mcp add:

claude mcp add -e FMP_API_KEY=your_api_key_here -s user financial-modeling-prep -- npx -y @houtini/fmp-mcp

使用以下命令验证:

claude mcp get financial-modeling-prep

你应该会看到 Status: Connected。

可用工具

核心市场数据
get_quote

获取实时股票报价数据。

参数:

  • symbol(必填):股票代码(例如,AAPL、TSLA、MSFT)

返回: 当前价格、交易量、市值、市盈率、当日最高价/最低价等。

search_symbol

按公司名称或股票代码搜索股票代码。

参数:

  • query(必填):搜索查询(公司名称或部分股票代码)

返回: 匹配的股票代码、公司名称和交易所信息。

公司基本面
get_company_profile

获取详细的公司简介和基本面数据。

参数:

  • symbol(必填):股票代码

返回: 公司简介、行业、板块、CEO、员工人数、总部、网站和关键财务指标。

get_income_statement

获取公司损益表数据。

参数:

  • symbol(必填):股票代码
  • period(可选):"annual" 或 "quarter"(默认:"annual")
  • limit(可选):要返回的期间数(默认:5)

**返回:**收入、支出、净收入、EPS 及其他盈利能力指标。

get_balance_sheet

获取公司资产负债表数据。

参数:

  • symbol(必填):股票代码
  • period(可选):"annual" 或 "quarter"(默认:"annual")
  • limit(可选):要返回的期间数(默认:5)

**返回:**资产、负债、股东权益及详细的报表项目。

get_cash_flow

获取公司现金流量表数据。

参数:

  • symbol(必填):股票代码
  • period(可选):"annual" 或 "quarter"(默认:"annual")
  • limit(可选):要返回的期间数(默认:5)

**返回:**经营活动现金流、投资活动、筹资活动和自由现金流。

get_key_metrics

获取关键财务指标和比率。

参数:

  • symbol(必填):股票代码
  • period(可选):"annual" 或 "quarter"(默认:"annual")
  • limit(可选):要返回的期间数(默认:5)

**返回:**市盈率、ROE、ROA、债务比率、流动比率等。

get_financial_ratios

获取详细的财务比率(盈利能力、流动性、效率)。

参数:

  • symbol(必填):股票代码
  • period(可选):"annual" 或 "quarter"(默认:"annual")
  • limit(可选):要返回的期间数(默认:5)

**返回:**全面的比率分析,包括盈利能力、流动性和效率指标。

市场表现
get_market_gainers

获取涨幅最大的股票。

**参数:**无

**返回:**涨幅领先的股票及其价格变动和成交量。

get_market_losers

获取跌幅最大的股票。

**参数:**无

**返回:**跌幅领先的股票及其价格变动和成交量。

get_most_active

获取成交量最高的活跃交易股票。

**参数:**无

**返回:**成交量最高的股票。

get_sector_performance

获取当前板块表现快照。

参数:

  • date(可选):YYYY-MM-DD 格式的日期(默认为最新日期)

**返回:**所有市场板块的表现指标。

分析师数据
get_analyst_estimates

获取分析师财务预测(收入、EPS 预测)。

参数:

  • symbol(必填):股票代码
  • period(可选):"annual" 或 "quarter"(默认:"annual")
  • limit(可选):要返回的期间数(默认:10)

**返回:**分析师对收入和收益的预测及一致预期数据。

get_price_target

获取分析师目标价汇总。

参数:

  • symbol(必填):股票代码

**返回:**分析师给出的目标价均值、最高值、最低值和中位数。

get_analyst_ratings

获取分析师评级及上调/下调评级信息。

参数:

  • symbol(必填):股票代码

**返回:**近期分析师评级变更、评级上调、评级下调和建议。

内部人交易与机构持仓
get_insider_trading

获取近期内部人交易活动。

参数:

  • symbol(必填):股票代码
  • limit(可选):要返回的交易笔数(默认:100)

**返回:**内部人的买卖交易,包括姓名、日期和金额。

get_institutional_holders

获取机构持仓情况(13F 文件)。

参数:

  • symbol(必填):股票代码
  • limit(可选):要返回的持有人数量(默认:100)

**返回:**主要机构持有人及其持股数量和申报日期。

技术指标
get_technical_indicator_rsi

获取相对强弱指数(RSI)。

参数:

  • symbol(必需):股票代码
  • timeframe(必需):"1min"、"5min"、"15min"、"30min"、"1hour"、"4hour"、"1day"
  • period(可选):周期长度(默认值:14)

**返回:**RSI 数值及时间戳,用于动量分析。

get_technical_indicator_sma

获取简单移动平均线(SMA)。

参数:

  • symbol(必需):股票代码
  • timeframe(必需):"1min"、"5min"、"15min"、"30min"、"1hour"、"4hour"、"1day"
  • period(可选):周期长度(默认值:10)

**返回:**SMA 数值及时间戳,用于趋势分析。

get_technical_indicator_ema

获取指数移动平均线(EMA)。

参数:

  • symbol(必需):股票代码
  • timeframe(必需):"1min"、"5min"、"15min"、"30min"、"1hour"、"4hour"、"1day"
  • period(可选):周期长度(默认值:10)

**返回:**EMA 数值及时间戳,用于趋势分析。

历史数据
get_historical_chart

获取具有灵活时间间隔的历史价格数据。

参数:

  • symbol(必需):股票代码
  • interval(必需):"1min"、"5min"、"15min"、"30min"、"1hour"、"4hour"
  • from(可选):开始日期,格式为 YYYY-MM-DD
  • to(可选):结束日期,格式为 YYYY-MM-DD

**返回:**指定时间间隔内的 OHLC 价格数据及成交量。

经济数据
get_economic_calendar

获取即将发布的经济数据日历。

参数:

  • from(可选):开始日期,格式为 YYYY-MM-DD
  • to(可选):结束日期,格式为 YYYY-MM-DD

**返回:**已安排的经济公告及其日期和预期影响。

get_economic_indicator

获取经济指标数据(GDP、失业率、通胀等)。

参数:

  • name(必需):指标名称(例如:"GDP"、"unemploymentRate"、"CPI")
  • from(可选):开始日期,格式为 YYYY-MM-DD
  • to(可选):结束日期,格式为 YYYY-MM-DD

**返回:**指定经济指标的历史数值。

事件与日历
get_earnings_calendar

获取即将发布的财报日历。

参数:

  • from(可选):开始日期,格式为 YYYY-MM-DD
  • to(可选):结束日期,格式为 YYYY-MM-DD

**返回:**即将公布财报的日期及每股收益(EPS)预估值。

指数数据
get_sp500_constituents

获取标普 500 指数成分股列表。

**参数:**无

**返回:**标普 500 指数的所有公司及其代码和详细信息。

新闻(付费功能)
get_stock_news

获取某只股票的最新新闻文章。

参数:

  • symbol(必需):股票代码
  • limit(可选):返回的文章数量(默认值:10)

**返回:**新闻标题、发布日期、URL 和文章摘要。

**注意:**此端点需要付费的 FMP 套餐。

使用示例

安装后,你可以通过 Claude Desktop 直接与 MCP 服务交互:

Get a quote for Apple stock
Show me Tesla's quarterly income statements for the last 8 quarters
What are today's biggest market gainers?
Get analyst price targets for NVIDIA
Show me insider trading activity for Microsoft
Calculate the 14-day RSI for TSLA on the daily timeframe
What's the current sector performance?
Get upcoming earnings announcements for this week
Show me institutional holders of Amazon

API 速率限制

Financial Modeling Prep 提供不同的定价档位:

  • 免费档:每天 250 次请求
  • 入门版:每天 500 次请求
  • 专业版:每天 1,000 次以上请求

当前套餐和限制请参阅 FMP 定价。

开发

本地安装
git clone https://github.com/houtini-ai/fmp-mcp.git
cd fmp-mcp
npm install
npm run build
Claude Desktop 本地开发配置
{
  "mcpServers": {
    "financial-modeling-prep": {
      "command": "node",
      "args": [
        "/absolute/path/to/fmp-mcp/build/index.js"
      ],
      "env": {
        "FMP_API_KEY": "your_api_key_here"
      }
    }
  }
}
构建
npm run build

输出将写入 build/ 目录。

API 覆盖范围

此 MCP 服务实现了 Financial Modeling Prep API 的 29 个端点:

核心市场数据(3)

  • 股票报价、代码搜索、公司简介

财务报表(6)

  • 损益表、资产负债表、现金流量表、关键指标、财务比率(年度和季度)

市场表现(4)

  • 涨幅榜、跌幅榜、交易最活跃股票、板块表现

分析师数据(3)

  • 预测、目标价、评级

内部人士与机构(2)

  • 内部人士交易、机构持有人

技术指标(3)

  • RSI、SMA、EMA,支持多个时间范围

历史数据(1)

  • 盘中图表(1min 至 4hour)

经济数据(2)

  • 经济日历、经济指标

事件与日历(1)

  • 财报日历

指数数据(1)

  • S&P 500 成分股

新闻(1)

  • 股票新闻(付费功能)

完整的 API 参考请参阅 FMP 开发者文档。

故障排除

MCP 服务未显示在 Claude Desktop 中
  1. 确认 claude_desktop_config.json 的语法是有效的 JSON
  2. 检查是否已设置 FMP_API_KEY 环境变量
  3. 完全重启 Claude Desktop(从系统托盘/菜单栏退出)
  4. 检查 Claude Desktop 日志中的错误消息
API 身份验证错误

如果看到 403 Forbidden 错误:

  • 确认 API 密钥正确
  • 检查是否超出了速率限制
  • 确保 API 密钥具有所需权限
工具执行失败

贡献

欢迎贡献!欢迎提交 Pull Request。

许可证

MIT 许可证——详情请参阅 LICENSE 文件。

资源

致谢

本项目基于 Anthropic 提供的 Model Context Protocol SDK 构建。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。