Skip to main content
Glama

FinanceMCP

by guangxiangdebizi
npmGitHub
JavaScript
MIT License
131
177
  • Apple
  • Linux
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

FinanceMCP - 专业金融数据MCP服务器 🚀

基于MCP协议的专业金融数据服务器，集成Tushare API，为Claude等AI助手提供实时金融数据和技术指标分析。

📑 目录

🌟 公共云服务(免费)

🎉 开箱即用，无需部署！ 我们提供多种免费公共云服务选项：

🌐 Web在线体验版

🚀 最简单的使用方式！

访问我们的在线体验网站：http://106.14.205.176:3090/

  • ✨ 零配置体验 - 无需任何设置，打开网页即用
  • 🤖 集成大模型 - 直接与AI助手对话，获取金融分析
  • 💬 智能交互 - 自然语言提问，实时获取金融数据
  • 📱 多端适配 - 支持电脑、手机、平板访问

⚠️ 服务说明: 这是个人小服务器，请合理使用，勿攻击滥用。

⚙️ Claude桌面版配置

🆕 最新版本(v4.2.1) - 使用您的API密钥

🎯 推荐生产环境使用，配置您自己的Tushare令牌：

{ "mcpServers": { "finance-mcp": { "disabled": false, "timeout": 600, "type": "streamableHttp", "url": "http://106.14.205.176:8080/mcp", "headers": { "X-Tushare-Token": "您的tushare令牌" } } } }

🔑 如何获取您的Tushare令牌：

  1. 在 tushare.pro 注册账户
  2. 从个人中心获取API令牌
  3. 将 您的tushare令牌 替换为您的实际令牌
🎁 传统免费服务(有限制)

您也可以使用我们的共享服务，无需API密钥(可能有速率限制)：

{ "mcpServers": { "finance-data-server": { "disabled": false, "timeout": 600, "type": "sse", "url": "http://106.14.205.176:3101/sse" } } }

服务优势:

  • ✅ 最新版本(v4.2.1) - 使用您自己的API密钥，享受无限制访问
  • ✅ 7×24可用 - 服务器持续运行
  • ✅ 完整功能 - 全部14个工具和技术指标
  • ✅ 实时数据 - 连接Tushare专业数据
  • ✅ 无速率限制 - 使用您自己的令牌，享受无限API调用
  • ✅ 生产就绪 - 稳定的streamable HTTP协议

📺 教程视频: FinanceMCP完整使用指南

⚡ 核心特色

🧠 智能技术指标系统

  • 智能数据预取 - 自动计算所需历史数据，消除NaN值
  • 强制参数化 - 要求明确指定参数（如macd(12,26,9)）确保精确性
  • 模块化架构 - 参数解析、数据计算、指标引擎完全解耦
  • 5大核心指标 - MACD、RSI、KDJ、BOLL、MA

🌍 全面市场覆盖

  • 10大市场 - A股、美股、港股、外汇、期货、基金、债券、期权
  • 实时新闻 - 智能搜索7+主流财经媒体
  • 宏观数据 - 11个经济指标（GDP、CPI、PPI、PMI等）
  • 公司分析 - 财务报表、管理层信息、股东结构

🛠️ 工具概览

工具名称功能描述核心特色
🕐 current_timestamp当前时间戳UTC+8时区，多种输出格式
📰 finance_news财经新闻搜索百度新闻爬虫；入参：query（空格分隔多关键词，OR 过滤）
📈 stock_data股票/加密 + 技术指标10大市场+加密(Binance默认)+5技术指标，智能预取
📊 index_data指数数据主要市场指数历史数据
🧱 csi_index_constituentsCSI指数成分与权重摘要仅支持中证指数公司(CSI)，指数区间行情 + 成分股权重与区间涨跌幅 + 估值/财务指标（PE、PB、股息率、ROE、ROA、净利率、经营现金流、资产负债率、营收同比、资产周转率、毛利率、三费比率、现金分红率）
📉 macro_econ宏观经济数据11指标：GDP/CPI/PPI/PMI/Shibor等
🏢 company_performanceA股公司财务分析财务报表+管理层+基本面，13数据类型
🏛️ company_performance_hk港股公司财务分析港股利润表、资产负债表、现金流量表
🇺🇸 company_performance_us美股公司财务分析美股4大财务报表+综合财务指标分析
💰 fund_data基金数据净值/持仓/分红，85%性能优化
👨‍💼 fund_manager_by_name基金经理查询个人背景、管理基金列表
🪙 convertible_bond可转债数据基本信息+发行数据+转换条款
🔄 block_trade大宗交易数据交易详情+交易对手信息
💹 money_flow资金流向数据主力/超大单/大单/中单/小单流向分析
💰 margin_trade融资融券数据4个API：标的股票/汇总/明细/转融券
🐯 dragon_tiger_inst龙虎榜机构明细指定交易日(可选代码)，买卖额/比例/净额/理由表格
🔥 hot_news_7x247×24 热点基于 Tushare 最新批次（单次至多1500条），内容相似度80%去重，条目间以---分隔

🎯 技术亮点

智能技术指标引擎

用户请求 → 参数解析 → 数据需求计算 → 扩展历史数据获取 → 指标计算 → 结果返回

支持的指标:

  • MACD macd(12,26,9) - 趋势分析
  • RSI rsi(14) - 超买超卖判断
  • KDJ kdj(9,3,3) - 随机指标
  • BOLL boll(20,2) - 布林带
  • MA ma(5/10/20/60) - 移动平均线

核心技术优势

  1. 智能预取 - 自动计算并获取指标所需的额外历史数据
  2. 参数强制 - 避免默认参数造成的计算差异
  3. 高性能 - 基金数据查询性能提升85%（5.2s→0.8s）
  4. 数据集成 - 无缝集成43+个Tushare API接口

🚀 快速开始

1. 使用公共云服务(推荐)

复制上方JSON配置到Claude桌面配置文件，重启Claude即可开始使用！

2. 配置文件位置

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

3. 开始使用

配置完成后，直接在Claude中提问即可！

💡 示例查询

"分析茅台(600519.SH)技术面状况，计算MACD(12,26,9)、RSI(14)、KDJ(9,3,3)" "查看宁德时代(300750.SZ)布林带BOLL(20,2)和四条均线MA(5,10,20,60)" "苹果公司(AAPL)近一个月股价走势和MACD指标分析"
"比亚迪综合分析：财务状况、技术指标、资金流向、最新新闻" "对比A股、美股、港股市场表现，包括主要指数和技术指标" "评估宁德时代投资价值：基本面+技术面+资金流向" "获取沪深300(000300.SH) 2024-01-01 至 2024-06-30 的CSI成分股区间摘要"
"获取中证证券公司(399975.SZ) 在 2024-01-01 至 2024-06-30 区间的成分股摘要（含PE、PB、股息率、ROE、ROA、净利率、经营现金流、资产负债率、营收同比、资产周转率、毛利率、三费比率、现金分红率）"
"搜索新能源汽车板块最新政策和市场动态" "分析当前宏观经济形势：GDP、CPI、PPI、PMI数据" "美联储加息对中国股市的影响，相关新闻和数据"
"查询沪深300ETF最新净值和持仓结构" "分析张坤的基金业绩表现" "可转债市场概况和投资机会"
"获取腾讯控股(00700.HK) 2024年利润表，包含关键财务比率" "分析阿里巴巴(09988.HK)资产负债表和财务结构" "对比建设银行(00939.HK)多期现金流表现"
"查询20240525的龙虎榜机构明细" "查询20240525的龙虎榜机构明细（聚焦000001.SZ）"
"分析英伟达(NVDA) 2024年财务表现，包括利润表和现金流" "获取苹果(AAPL)资产负债表，重点关注现金储备和负债结构" "对比特斯拉(TSLA)多期财务指标，分析盈利能力变化趋势" "查看微软(MSFT)综合财务指标，包括ROE、ROA、毛利率等"
"查看比特币(BTC-USD) 2024-01-01 至 2024-06-30 的走势，计算 MACD(12,26,9) 和 RSI(14)" "查看 USDT 对 CNY 的日线走势：market_type=crypto, code=USDT.CNY, start_date=20240101, end_date=20240630" "使用 CoinGecko id 查询：market_type=crypto, code=bitcoin.usd, indicators=\"boll(20,2) ma(5) ma(10)\""

🔧 本地部署（Streamable HTTP）

如果需要本地部署，请按以下步骤操作：

环境要求

  1. 注册账户 - 访问tushare.pro注册
  2. 获取令牌 - 从个人中心获取API令牌
  3. 积分说明 - 部分高级数据需要积分

学生福利 - 申请2000免费积分：

  • 关注Tushare官方小红书并互动
  • 加入学生QQ群：290541801
  • 完善个人信息（学校邮箱/学号）
  • 向管理员提交申请材料

安装步骤

方法1：通过npm包安装(推荐)
# 全局安装 npm install -g finance-mcp # 或本地安装 npm install finance-mcp

安装后可以直接使用：

# 如果全局安装 finance-mcp # 如果本地安装 npx finance-mcp
方法2：通过Smithery安装
npx -y @smithery/cli install @guangxiangdebizi/finance-mcp --client claude
方法3：手动安装
# 1. 克隆仓库 git clone https://github.com/guangxiangdebizi/FinanceMCP.git cd FinanceMCP # 2. 安装依赖 npm install # 3. 配置API密钥 echo "TUSHARE_TOKEN=your_token_here" > .env # 或直接编辑 src/config.ts # 4. 构建项目 npm run build

启动服务

Streamable HTTP 模式（推荐）

npm run build node build/httpServer.js # 或 npm run start:http

SSE 模式

npm run build npm run start:sse

服务启动后：

  • MCP 端点: http://localhost:3000/mcp
  • 健康检查: http://localhost:3000/health

Claude配置

配置文件位置：

  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
最新配置：Streamable HTTP 模式（通过 Header 传入 Token）
{ "mcpServers": { "finance-data-server": { "type": "streamableHttp", "url": "http://localhost:3000/mcp", "timeout": 600, "headers": { "X-Tushare-Token": "your_tushare_token" } } } }
传递 Token 的 Header 规则
  • 优先从 X-Tushare-Token 读取；
  • 若未提供，则尝试 Authorization: Bearer <token>；
  • 再次回退读取 X-Api-Key；
  • 若 Header 中未提供，则回退使用服务端环境变量 TUSHARE_TOKEN（可选）。

（加密市场默认使用 Binance 公共行情接口，无需任何加密货币 API Key）

验证安装

配置完成后，重启Claude桌面版并询问："获取当前时间"。如果返回时间信息，说明安装成功。

🆕 最新更新

🚀 版本 4.2.1 - 分钟K线数据版本

最新重大更新：我们发布了v4.2.1版本，新增分钟级别K线数据查询功能！

  • ⏱ 分钟K线工具 - 新增 stock_data_minutes 工具，支持A股分钟级别K线数据
  • 📊 多频率支持 - 支持1MIN/5MIN/15MIN/30MIN/60MIN多种时间周期
  • 🕐 精确时间控制 - 支持精确到秒的时间范围查询
  • 📈 实时交易数据 - 获取开盘/最高/最低/收盘/成交量/成交额完整数据
  • ₿ 虚拟货币行情数据 - 实时加密货币价格、交易量和市场分析
  • 🔗 多交易所支持 - 来自主要加密货币交易所的数据
  • 📊 加密货币技术指标 - 为数字资产提供MACD、RSI、KDJ、BOLL、MA指标
  • 💹 市值与交易量分析 - 全面的加密货币市场指标
  • 🌐 Web在线体验 - 全新Web界面 http://106.14.205.176:3090/
  • 🤖 集成大模型 - 直接与AI助手对话，获取金融分析
  • 💬 智能交互 - 自然语言提问，实时获取金融数据
  • 📱 多端适配 - 支持电脑、手机、平板访问
  • ✨ 零配置体验 - 无需任何设置，打开网页即用
  • 📦 NPM包 - 现已在npm注册表中以 finance-mcp 名称发布
  • 🌐 公共云服务 - 生产就绪的部署地址 http://106.14.205.176:8080/mcp
  • 🔑 自定义API密钥 - 使用您自己的Tushare令牌享受无限制访问
  • ⚡ Streamable HTTP - 增强的协议支持，更好的性能
  • 🛡️ 生产稳定性 - 改进的错误处理和会话管理
  • 📈 无速率限制 - 使用您自己的令牌，享受无限API调用
  • 🔧 简易安装 - 简单的npm安装和配置

迁移指南：更新您的Claude配置以使用新的streamable HTTP端点和您自己的API密钥，获得最佳体验。

🧱 CSI 指数成分摘要工具增强 (NEW!)

  • 指数区间行情 + 成分股权重与区间涨跌幅
  • 新增估值/财务指标：PE(TTM)、PB、股息率、ROE、ROA、净利率、每股经营现金流、资产负债率、营收同比、资产周转率、毛利率、三费比率、现金分红率
  • 支持 .SH/.SZ 形式的中证指数代码（如 399975.SZ），自动回退查找最近权重日与估值日

🇺🇸 美股财务分析模块 (NEW!)

最新添加：我们新增了完整的美股财务分析功能！

  • 🇺🇸 company_performance_us - 专业的美股财务分析工具
  • 📈 利润表分析 - 营业收入、毛利率、净利润、每股收益分析
  • 💰 资产负债表分析 - 资产、负债、股东权益结构与财务比率
  • 💸 现金流量表分析 - 经营、投资、筹资现金流与自由现金流
  • 📊 综合财务指标 - ROE、ROA、盈利能力、成长性、偿债能力等
  • 🎯 智能数据处理 - 多期对比分析、趋势计算、关键指标提取
  • 🌟 中英文兼容 - 支持中英文财务科目智能识别

支持公司：覆盖主要美股和中概股，包括英伟达(NVDA)、苹果(AAPL)、特斯拉(TSLA)、微软(MSFT)等。

API集成：基于Tushare美股财务数据API，4大数据接口完整集成。

🏛️ 港股财务分析模块

已添加：我们新增了全面的港股财务分析功能！

  • 🏛️ company_performance_hk - 专门的港股财务分析工具
  • 📈 利润表分析 - 营业额、利润率、每股收益、综合收益分析
  • 💰 资产负债表分析 - 资产、负债、权益结构与关键财务比率
  • 💸 现金流量表分析 - 经营、投资、筹资活动与自由现金流计算
  • 🎯 智能数据处理 - 自动财务比率计算和多期对比分析
  • 🌟 增强用户体验 - 结构化表格、智能分类、趋势分析

支持公司：所有港交所上市公司，包括腾讯(00700.HK)、阿里巴巴(09988.HK)、建设银行(00939.HK)等。

API集成：基于Tushare港股财务数据API，完整数据格式优化。

⏱ 分钟K线工具 (NEW!)

新增工具 stock_data_minutes，用于获取A股分钟级别K线数据。

  • 频率：支持 1MIN/5MIN/15MIN/30MIN/60MIN
  • 入参：
    • code: 股票代码，如 600519.SH、000001.SZ
    • start_datetime: 起始时间，YYYYMMDDHHmmss 或 YYYY-MM-DD HH:mm:ss
    • end_datetime: 结束时间，YYYYMMDDHHmmss 或 YYYY-MM-DD HH:mm:ss
    • freq: 周期，例 1MIN
  • 返回：按时间倒序的表格（时间/开盘/最高/最低/收盘/成交量/成交额(万元)）

示例（tools/call）：

name: stock_data_minutes arguments: code: 600519.SH start_datetime: 2024-09-01 09:30:00 end_datetime: 2024-09-01 10:30:00 freq: 1MIN

📄 许可证

本项目采用MIT许可证。详见LICENSE文件。

👨‍💻 作者: 陈星宇
📧 邮箱: guangxiangdebizi@gmail.com
🔗 GitHub: guangxiangdebizi

⭐ 如果这个项目对您有帮助，请给我们一个Star！

Deploy Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

Provides real-time financial data to language models via MCP protocol, enabling access to stock prices, market indices, and financial news through Tushare API.

  1. 📑 目录
    1. 🌟 公共云服务(免费)
      1. 🌐 Web在线体验版
      2. ⚙️ Claude桌面版配置
    2. ⚡ 核心特色
      1. 🧠 智能技术指标系统
      2. 🌍 全面市场覆盖
    3. 🛠️ 工具概览
      1. 🎯 技术亮点
        1. 智能技术指标引擎
        2. 核心技术优势
      2. 🚀 快速开始
        1. 1. 使用公共云服务(推荐)
        2. 2. 配置文件位置
        3. 3. 开始使用
      3. 💡 示例查询
        1. 🔧 本地部署（Streamable HTTP）
          1. 环境要求
          2. 安装步骤
          3. 启动服务
          4. Claude配置
          5. 验证安装
        2. 🆕 最新更新
          1. 🚀 版本 4.2.1 - 分钟K线数据版本
          2. 🧱 CSI 指数成分摘要工具增强 (NEW!)
          3. 🇺🇸 美股财务分析模块 (NEW!)
          4. 🏛️ 港股财务分析模块
        3. ⏱ 分钟K线工具 (NEW!)
          1. 📄 许可证

            Related Resources

            Related MCP Servers

            • Financial Datasets MCP Serverofficial

              financial-datasets
              A
              security
              A
              license
              A
              quality
              MCP server that provides AI assistants access to stock market data including financial statements, stock prices, and market news through a Model Context Protocol interface.
              Last updated 3 months ago
              11
              513
              MIT License
              • Apple

            • Global MCP Stock Server

              sakura-ku
              -
              security
              F
              license
              -
              quality
              Provides real-time access to global stock market data including current prices, historical charts, and company financial information through a Model Context Protocol (MCP) server for AI assistants.
              Last updated 5 months ago
              • Linux
              • Apple

            • Finance Tools MCP

              VoxLink-org
              A
              security
              A
              license
              A
              quality
              An MCP server that provides comprehensive financial insights and analysis by leveraging real-time market data, news, and advanced analytics for stocks, options, financial statements, and economic indicators.
              Last updated 5 days ago
              17
              46
              Python
              MIT License
              • Apple

            • Finance MCP Server

              botextractai
              -
              security
              F
              license
              -
              quality
              A Model Context Protocol server built with FastMCP that provides financial data tools for AI agents, enabling them to access and analyze stock market information from Yahoo Finance through natural language queries.
              Last updated 2 days ago
              2

            View all related MCP servers

            New MCP Servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/guangxiangdebizi/FinanceMCP'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server