Skip to content

这是一个金融领域相关的mcp,本项目通过集成 Tushare API 为语言模型(如Claude)提供全面的实时金融数据访问能力,支持股票、基金、债券、宏观经济指标等多维度金融数据分析。其中也包含了金融数据查询、财经新闻查询、国家统计局数据查询等

License

Notifications You must be signed in to change notification settings

guangxiangdebizi/FinanceMCP

Repository files navigation

English

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

smithery badge

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

📑 目录

🌟 公共云服务(免费)

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

🌐 Web在线体验版

🚀 最简单的使用方式!

image

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

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

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

⚙️ Claude桌面版配置

🆕 最新版本(v4.0.0) - 使用您的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.0.0) - 使用您自己的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大市场+5技术指标,智能预取
📊 index_data 指数数据 主要市场指数历史数据
🧱 csi_index_constituents CSI指数成分与权重摘要 仅支持中证指数公司(CSI),指数区间行情 + 成分股权重与区间涨跌幅 + 估值/财务指标(PE、PB、股息率、ROE、ROA、净利率、经营现金流、资产负债率、营收同比、资产周转率、毛利率、三费比率、现金分红率)
📉 macro_econ 宏观经济数据 11指标:GDP/CPI/PPI/PMI/Shibor等
🏢 company_performance A股公司财务分析 财务报表+管理层+基本面,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_7x24 7×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成分股区间摘要"
🧱 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、毛利率等"

🔧 本地部署(Streamable HTTP)

🛠️ 完整本地部署指南

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

环境要求

📝 获取Tushare API令牌
  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 传入 Tushare Token)

{
  "mcpServers": {
    "finance-data-server": {
      "type": "streamableHttp",
      "url": "http://localhost:3000/mcp",
      "timeout": 600,
      "headers": {
        "X-Tushare-Token": "your_tushare_token"
        // 也可使用以下任一方式:
        // "Authorization": "Bearer your_tushare_token"
        // "X-Api-Key": "your_tushare_token"
      }
    }
  }
}

传递 Token 的 Header 规则

  • 优先从 X-Tushare-Token 读取;
  • 若未提供,则尝试 Authorization: Bearer <token>
  • 再次回退读取 X-Api-Key
  • 若 Header 中未提供,则回退使用服务端环境变量 TUSHARE_TOKEN(可选)。

验证安装

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

🆕 最新更新

🚀 版本 4.0.0 - 增强Web体验版本

最新重大更新:我们发布了v4.0.0版本,具备全面的Web体验和增强功能!

🎯 v4.0.0新功能
  • 🌐 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,完整数据格式优化。

📄 许可证

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


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

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

About

这是一个金融领域相关的mcp,本项目通过集成 Tushare API 为语言模型(如Claude)提供全面的实时金融数据访问能力,支持股票、基金、债券、宏观经济指标等多维度金融数据分析。其中也包含了金融数据查询、财经新闻查询、国家统计局数据查询等

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •