财务MCP

作者：guangxiangdebizi317 星标更新：2025-11-11

安装使用来源：spider==github.com

项目介绍

技术文档摘要

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

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

📑 目录

🌟 公共云服务（免费）
⚡ 核心特性
🛠️ 工具概览
🎯 技术亮点
🚀 快速开始
💡 示例查询
🔧 本地部署
🆕 最新更新
📄 许可证

🌟 公共云服务（免费）

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

🌐 网络在线体验版

🚀 使用最简单的方式！

访问我们的在线体验网站：https://finvestai.top/

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

⚠️ 服务说明 这是一个个人小服务器，请合理使用，不要攻击或滥用。

⚙️ Claude桌面配置

🆕 最新版本（v4.3.0）- 使用您的API密钥

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

{
  "mcpServers": {
    "finance-mcp": {
      "disabled": false,
      "timeout": 600,
      "type": "streamableHttp",
      "url": "https://finvestai.top/mcp",
      "headers": {
        "X-Tushare-Token": "您的tushare令牌"
      }
    }
  }
}

🔑 如何获取您的Tushare令牌：

在 tushare.pro 注册一个账户
从个人中心获取API令牌
将 您的tushare令牌 翻译成英文并替换为您实际的令牌

🎁 传统免费服务（有限制）

您也可以在没有API密钥的情况下使用我们的共享服务（可能会有速度限制）：

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

服务优势：

✅ 最新版本（v4.3.0） -使用自己的API密钥享受无限访问
✅ 7 × 24可用 -服务器持续运行
✅ 全功能 -所有14个工具和技术指标
✅ 实时数据 -连接Tushare专业数据
✅ 无速度限制 -使用自己的令牌享受无限API调用
✅ 生产就绪 -稳定的流式HTTP协议

📺 教程视频：FinceMCP 完整用户指南

⚡ 核心特性

🧠 智能技术指标系统

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

🌍 全面市场覆盖

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

🛠️ 工具概览

工具名称	功能描述	核心特性
🕐 current_timestamp	当前时间戳	UTC+8时区，多种输出格式
📰 finance_news	财经新闻搜索	百度新闻爬虫；参与：`query`(多个关键词之间用空格分隔，OR过滤)
📈 stock_data	股票/加密货币+技术指标	十大市场+加密货币（默认Binance）+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	美股公司财务分析	分析四大财务报表及综合财务指标
💰 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) -移动平均线

核心技术优势

智能预取 -自动计算并获取指标所需的额外历史数据
参数强制 -避免因默认参数引起的计算差异
高性能 -基金数据查询性能提升85%（5.2秒 → 0.8秒）
数据整合 -无缝整合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中提问即可！

💡 示例查询

<details> <summary>📈 股票技术分析</summary>

"分析茅台(600519.SH)技术面状况，计算MACD(12,26,9)、RSI(14)、KDJ(9,3,3)"
"查看宁德时代(300750.SZ)布林带BOLL(20,2)和四条均线MA(5,10,20,60)"
"苹果公司(AAPL)近一个月股价走势和MACD指标分析"

</details> <details> <summary>📊 综合分析</summary>

"比亚迪综合分析：财务状况、技术指标、资金流向、最新新闻"
"对比A股、美股、港股市场表现，包括主要指数和技术指标"
"评估宁德时代投资价值：基本面+技术面+资金流向"
"获取沪深300(000300.SH) 2024-01-01 至 2024-06-30 的CSI成分股区间摘要"

</details> <details> <summary>🧱 CSI 指数成分与权重（含估值/财务）</summary>

"获取中证证券公司(399975.SZ) 在 2024-01-01 至 2024-06-30 区间的成分股摘要（含PE、PB、股息率、ROE、ROA、净利率、经营现金流、资产负债率、营收同比、资产周转率、毛利率、三费比率、现金分红率）"

</details> <details> <summary>💰 资金流向分析</summary>

"查询证券板块(BK0447)近一个月的资金流向情况"
"分析2024年9月27日所有行业板块的资金流入排名"
"比亚迪(002594.SZ)最近的主力资金流向和超大单净流入"
"查看大盘整体资金流向，分析市场情绪"
"获取2024年10月所有概念板块的资金流向数据"

</details> <details> <summary>📰 新闻与宏观</summary>

"搜索新能源汽车板块最新政策和市场动态"
"分析当前宏观经济形势：GDP、CPI、PPI、PMI数据"
"美联储加息对中国股市的影响，相关新闻和数据"

</details> <details> <summary>💰 基金与债券</summary>

"查询沪深300ETF最新净值和持仓结构"
"分析张坤的基金业绩表现"
"可转债市场概况和投资机会"

</details> <details> <summary>🏛️ 港股分析</summary>

"获取腾讯控股(00700.HK) 2024年利润表，包含关键财务比率"
"分析阿里巴巴(09988.HK)资产负债表和财务结构"
"对比建设银行(00939.HK)多期现金流表现"

</details> <details> <summary>🐯 龙虎榜</summary>

"查询20240525的龙虎榜机构明细"
"查询20240525的龙虎榜机构明细（聚焦000001.SZ）"

</details> <details> <summary>🇺🇸 美股分析</summary>

"分析英伟达(NVDA) 2024年财务表现，包括利润表和现金流"
"获取苹果(AAPL)资产负债表，重点关注现金储备和负债结构"
"对比特斯拉(TSLA)多期财务指标，分析盈利能力变化趋势"
"查看微软(MSFT)综合财务指标，包括ROE、ROA、毛利率等"

</details> <details> <summary>🪙 加密资产</summary>

"查看比特币(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)\""

</details>

🔧 本地部署（流式HTTP）

<details> <summary>🛠️ 完整本地部署指南</summary>

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

环境要求

Node.js >= 18 -从nodejs.org下载
Tushare API Token -从tushare.pro获取

<details> <summary>📝 获取Tushare API令牌</summary>

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

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

关注Tushare官方小红书并与其互动
加入学生QQ群：两亿九千五百四十万一千八百零一
完善个人信息（学校邮箱/学号）
向管理员提交申请材料

</details>

安装步骤

方法1：通过npm包安装（推荐）

# 全局安装
npm install -g finance-mcp

# 或本地安装
npm install finance-mcp

安装后可以直接使用：

# 如果是全局安装
finance-mcp

# 如果是本地安装
npx finance-mcp

方法2：通过Smithery安装

npx -y @smithery/cli install @guangxiangdebizi/FinanceMCP --client claude

💡 提示 Finance MCP支持两种部署模式

STDio模式（默认，推荐本地使用）：npx -y finance-mcp

HTTP模式（云部署）：npx -y finance-mcp-http

请参阅详细说明 DEPLOYMENT_MODES.md

方法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

启动服务

流式HTTP模式（推荐）

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

SSE模式

npm run build
npm run start:sse
``