This Financial News and Notes MCP Server provides access to various financial data via the Tushare API. With this server, you can:
Retrieve historical stock data for specified codes
Obtain historical index data for major market indices
Access the latest financial news from various sources
Fetch macro economic data (Shibor, LPR, GDP, CPI, PPI)
Process messages using various tools including ApiClient, DataProcessor, FileHandler, and customizable tools
Potential future features include data visualization, intelligent analysis, sentiment analysis, and expanded data sources like financial statements and fund data.
Implements a finance-focused server in TypeScript that provides access to financial news, stock and index data through Tushare API integration.
FinanceMCP - 专业金融数据MCP服务器 🚀
基于MCP协议的专业金融数据服务器,集成Tushare API,为Claude等AI助手提供实时金融数据和技术指标分析。
📑 目录
🌟 公共云服务(免费)
🎉 开箱即用,无需部署! 我们提供多种免费公共云服务选项:
🌐 Web在线体验版
🚀 最简单的使用方式!
访问我们的在线体验网站:http://106.14.205.176:3090/
- ✨ 零配置体验 - 无需任何设置,打开网页即用
- 🤖 集成大模型 - 直接与AI助手对话,获取金融分析
- 💬 智能交互 - 自然语言提问,实时获取金融数据
- 📱 多端适配 - 支持电脑、手机、平板访问
⚠️ 服务说明: 这是个人小服务器,请合理使用,勿攻击滥用。
⚙️ Claude桌面版配置
🆕 最新版本(v4.1.0) - 使用您的API密钥
🎯 推荐生产环境使用,配置您自己的Tushare令牌:
🔑 如何获取您的Tushare令牌:
- 在 tushare.pro 注册账户
- 从个人中心获取API令牌
- 将
您的tushare令牌
替换为您的实际令牌
🎁 传统免费服务(有限制)
您也可以使用我们的共享服务,无需API密钥(可能有速率限制):
服务优势:
- ✅ 最新版本(v4.1.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大市场+加密(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 | 美股公司财务分析 | 美股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)
- 移动平均线
核心技术优势
- 智能预取 - 自动计算并获取指标所需的额外历史数据
- 参数强制 - 避免默认参数造成的计算差异
- 高性能 - 基金数据查询性能提升85%(5.2s→0.8s)
- 数据集成 - 无缝集成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中提问即可!
💡 示例查询
🔧 本地部署(Streamable HTTP)
如果需要本地部署,请按以下步骤操作:
环境要求
- Node.js >= 18 - 从nodejs.org下载
- Tushare API令牌 - 从tushare.pro获取
- 注册账户 - 访问tushare.pro注册
- 获取令牌 - 从个人中心获取API令牌
- 积分说明 - 部分高级数据需要积分
学生福利 - 申请2000免费积分:
- 关注Tushare官方小红书并互动
- 加入学生QQ群:290541801
- 完善个人信息(学校邮箱/学号)
- 向管理员提交申请材料
安装步骤
方法1:通过npm包安装(推荐)
安装后可以直接使用:
方法2:通过Smithery安装
方法3:手动安装
启动服务
Streamable HTTP 模式(推荐)
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)
传递 Token 的 Header 规则
- 优先从
X-Tushare-Token
读取; - 若未提供,则尝试
Authorization: Bearer <token>
; - 再次回退读取
X-Api-Key
; - 若 Header 中未提供,则回退使用服务端环境变量
TUSHARE_TOKEN
(可选)。
(加密市场默认使用 Binance 公共行情接口,无需任何加密货币 API Key)
验证安装
配置完成后,重启Claude桌面版并询问:"获取当前时间"。如果返回时间信息,说明安装成功。
🆕 最新更新
🚀 版本 4.1.0 - 虚拟货币支持版本
最新重大更新:我们发布了v4.1.0版本,新增虚拟货币市场数据支持和增强功能!
- ₿ 虚拟货币行情数据 - 实时加密货币价格、交易量和市场分析
- 🔗 多交易所支持 - 来自主要加密货币交易所的数据
- 📊 加密货币技术指标 - 为数字资产提供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,完整数据格式优化。
📄 许可证
本项目采用MIT许可证。详见LICENSE文件。
👨💻 作者: 陈星宇
📧 邮箱: guangxiangdebizi@gmail.com
🔗 GitHub: guangxiangdebizi
⭐ 如果这个项目对您有帮助,请给我们一个Star!
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A TypeScript-based MCP server that enables users to query financial news, stock data, and index information while managing text notes with creation and summarization capabilities.
Related Resources
Related MCP Servers
- AsecurityFlicenseAqualityThis TypeScript-based MCP server enables users to manage and summarize text notes, providing tools for note creation and summarization prompts.Last updated -91710
- -securityFlicense-qualityA TypeScript-based MCP server that enables users to manage text notes and generate summaries, showcasing key MCP concepts like resource representation and LLM integration.Last updated -2,011
- AsecurityFlicenseAqualityA TypeScript-based MCP server that implements a simple notes system, allowing users to create, access, and generate summaries of text notes.Last updated -123
- AsecurityFlicenseAqualityA TypeScript-based MCP server that implements a simple notes system, allowing users to create, access, and generate summaries of text notes.Last updated -22