FinanceMCP
starsforks
How to install FinanceMCP?
guangxiangdebizi/financemcp
$git clone https://github.com/guangxiangdebizi/FinanceMCP基于MCP协议的专业金融数据服务器，集成Tushare API，为Claude等AI助手提供实时金融数据和技术指标分析。 </div>
README.md
| 1 | [](README_EN.md) |
| 2 | |
| 3 | # FinanceMCP (Synapse) - 专业金融数据MCP服务器 🚀 |
| 4 | |
| 5 | <div align="center"> |
| 6 | <img src="LOGO/LOGO.png" alt="FinanceMCP Logo" width="290"/> |
| 7 | |
| 8 | [](https://smithery.ai/server/@guangxiangdebizi/FinanceMCP) |
| 9 | |
| 10 | **基于MCP协议的专业金融数据服务器，集成Tushare API，为Claude等AI助手提供实时金融数据和技术指标分析。** |
| 11 | </div> |
| 12 | |
| 13 | ## 🔗 项目联动：FinNote 智能金融文档系统 |
| 14 | |
| 15 | FinanceMCP 已与 [MarkiNote](https://github.com/wink-wink-wink555/MarkiNote) 进行项目联动与融合，形成面向金融投研与智能文档管理场景的一体化项目 **FinNote**。该项目已参加上海市大学生计算机应用能力大赛，并获得省级二等奖，在线体验地址为：[https://finvestai.top/](https://finvestai.top/)。 |
| 16 | |
| 17 | 在 FinNote 整体架构中，FinanceMCP 作为后端金融数据 MCP 服务器，基于 Node.js、Express 与 MCP SDK 构建，负责封装和标准化多源金融数据能力。目前系统聚合 100+ 金融数据接口，并整理为 18 个 MCP 工具，为大模型提供股票、基金、债券、宏观经济、财经新闻、技术指标等多类型金融数据调用能力。 |
| 18 | |
| 19 | MarkiNote / FinNote 前端则作为 AI Agent 驱动的智能文档系统，负责接收用户自然语言需求，展示 AI 分析过程，并将分析结果保存为可管理、可追踪、可复用的文档资产。两者通过 HTTP 通讯，形成从“金融数据获取”到“智能分析”，再到“文档沉淀与知识管理”的完整闭环。 |
| 20 | |
| 21 | 因此，FinanceMCP 不仅可以作为独立的 MCP 金融数据服务器接入 Claude、GPT 等大模型，也可以作为 FinNote 的金融数据后端，为 AI Agent 文档系统提供实时、结构化、可调用的数据基础。 |
| 22 | |
| 23 | ## 📑 目录 |
| 24 | |
| 25 | - [🌟 公共云服务(免费)](#-公共云服务免费) |
| 26 | - [⚡ 核心特色](#-核心特色) |
| 27 | - [🛠️ 工具概览](#️-工具概览) |
| 28 | - [🎯 技术亮点](#-技术亮点) |
| 29 | - [🚀 快速开始](#-快速开始) |
| 30 | - [💡 示例查询](#-示例查询) |
| 31 | - [🔧 本地部署](#-本地部署) |
| 32 | - [🆕 最新更新](#-最新更新) |
| 33 | - [📄 许可证](#-许可证) |
| 34 | |
| 35 | ## 🌟 公共云服务(免费) |
| 36 | |
| 37 | **🎉 开箱即用，无需部署！** |
| 38 | 我们提供多种免费公共云服务选项： |
| 39 | |
| 40 | ### 🌐 Web在线体验版 |
| 41 | **🚀 最简单的使用方式！** |
| 42 | |
| 43 | <img width="1920" height="1080" alt="image" src="https://github.com/user-attachments/assets/5a81b053-4d19-4285-b5a2-991d14425595" /> |
| 44 | |
| 45 | 访问我们的在线体验网站：**[https://finvestai.top/](https://finvestai.top/)** |
| 46 | |
| 47 | - ✨ **零配置体验** - 无需任何设置，打开网页即用 |
| 48 | - 🤖 **集成大模型** - 直接与AI助手对话，获取金融分析 |
| 49 | - 💬 **智能交互** - 自然语言提问，实时获取金融数据 |
| 50 | - 📱 **多端适配** - 支持电脑、手机、平板访问 |
| 51 | |
| 52 | > ⚠️ **服务说明**: 这是个人小服务器，请合理使用，勿攻击滥用。 |
| 53 | |
| 54 | ### ⚙️ Claude桌面版配置 |
| 55 | |
| 56 | #### 🆕 最新版本(v4.3.0) - 使用您的API密钥 |
| 57 | **🎯 推荐生产环境使用，配置您自己的Tushare令牌：** |
| 58 | |
| 59 | ```json |
| 60 | { |
| 61 | "mcpServers": { |
| 62 | "finance-mcp": { |
| 63 | "disabled": false, |
| 64 | "timeout": 600, |
| 65 | "type": "streamableHttp", |
| 66 | "url": "https://finvestai.top/mcp", |
| 67 | "headers": { |
| 68 | "X-Tushare-Token": "您的tushare令牌" |
| 69 | } |
| 70 | } |
| 71 | } |
| 72 | } |
| 73 | ``` |
| 74 | |
| 75 | **🔑 如何获取您的Tushare令牌：** |
| 76 | 1. 在 [tushare.pro](https://tushare.pro/register) 注册账户 |
| 77 | 2. 从个人中心获取API令牌 |
| 78 | 3. 将 `您的tushare令牌` 替换为您的实际令牌 |
| 79 | |
| 80 | #### 🎁 传统免费服务(有限制) |
| 81 | 您也可以使用我们的共享服务，无需API密钥(可能有速率限制)： |
| 82 | |
| 83 | ```json |
| 84 | { |
| 85 | "mcpServers": { |
| 86 | "finance-data-server": { |
| 87 | "disabled": false, |
| 88 | "timeout": 600, |
| 89 | "type": "sse", |
| 90 | "url": "http://106.14.205.176:3101/sse" |
| 91 | } |
| 92 | } |
| 93 | } |
| 94 | ``` |
| 95 | |
| 96 | **服务优势:** |
| 97 | - ✅ **最新版本(v4.3.0)** - 使用您自己的API密钥，享受无限制访问 |
| 98 | - ✅ **7×24可用** - 服务器持续运行 |
| 99 | - ✅ **完整功能** - 全部14个工具和技术指标 |
| 100 | - ✅ **实时数据** - 连接Tushare专业数据 |
| 101 | - ✅ **无速率限制** - 使用您自己的令牌，享受无限API调用 |
| 102 | - ✅ **生产就绪** - 稳定的streamable HTTP协议 |
| 103 | |
| 104 | > 📺 **教程视频**: [FinanceMCP完整使用指南](https://www.bilibili.com/video/BV1qeNnzEEQi/) |
| 105 | |
| 106 | ## ⚡ 核心特色 |
| 107 | |
| 108 | ### 🧠 智能技术指标系统 |
| 109 | - **智能数据预取** - 自动计算所需历史数据，消除NaN值 |
| 110 | - **强制参数化** - 要求明确指定参数（如`macd(12,26,9)`）确保精确性 |
| 111 | - **模块化架构** - 参数解析、数据计算、指标引擎完全解耦 |
| 112 | - **5大核心指标** - MACD、RSI、KDJ、BOLL、MA |
| 113 | |
| 114 | ### 🌍 全面市场覆盖 |
| 115 | - **10大市场** - A股、美股、港股、外汇、期货、基金、债券、期权 |
| 116 | - **实时新闻** - 智能搜索7+主流财经媒体 |
| 117 | - **宏观数据** - 11个经济指标（GDP、CPI、PPI、PMI等） |
| 118 | - **公司分析** - 财务报表、管理层信息、股东结构 |
| 119 | |
| 120 | ## 🛠️ 工具概览 |
| 121 | |
| 122 | | 工具名称 | 功能描述 | 核心特色 | |
| 123 | |---------|---------|---------| |
| 124 | | 🕐 **current_timestamp** | 当前时间戳 | UTC+8时区，多种输出格式 | |
| 125 | | 📰 **finance_news** | 财经新闻搜索 | 百度新闻爬虫；入参：`query`（空格分隔多关键词，OR 过滤） | |
| 126 | | 📈 **stock_data** | 股票/加密 + 技术指标 | 10大市场+加密(Binance默认)+5技术指标，智能预取 | |
| 127 | | 📊 **index_data** | 指数数据 | 主要市场指数历史数据 | |
| 128 | | 🧱 **csi_index_constituents** | CSI指数成分与权重摘要 | 仅支持中证指数公司(CSI)，指数区间行情 + 成分股权重与区间涨跌幅 + 估值/财务指标（PE、PB、股息率、ROE、ROA、净利率、经营现金流、资产负债率、营收同比、资产周转率、毛利率、三费比率、现金分红率） | |
| 129 | | 📉 **macro_econ** | 宏观经济数据 | 11指标：GDP/CPI/PPI/PMI/Shibor等 | |
| 130 | | 🏢 **company_performance** | A股公司财务分析 | 财务报表+管理层+基本面，13数据类型 | |
| 131 | | 🏛️ **company_performance_hk** | 港股公司财务分析 | 港股利润表、资产负债表、现金流量表 | |
| 132 | | 🇺🇸 **company_performance_us** | 美股公司财务分析 | 美股4大财务报表+综合财务指标分析 | |
| 133 | | 💰 **fund_data** | 基金数据 | 净值/持仓/分红，85%性能优化 | |
| 134 | | 👨💼 **fund_manager_by_name** | 基金经理查询 | 个人背景、管理基金列表 | |
| 135 | | 🪙 **convertible_bond** | 可转债数据 | 基本信息+发行数据+转换条款 | |
| 136 | | 🔄 **block_trade** | 大宗交易数据 | 交易详情+交易对手信息 | |
| 137 | | 💹 * |
People who liked this also viewed
6 picksType
- FinanceToolkitTransparent and Efficient Financial AnalysisMCP ServersJul 2026
- mcp-serverAn MCP server for interacting with the Financial Datasets stock market API.MCP ServersJun 2025
- mcp-serverOfficial Python MCP server for local interactions with the QuantConnect APIMCP ServersMay 2026
- alpaca-mcp-serverAlpaca’s official MCP Server lets you trade stocks, ETFs, crypto, and options, run data analysis, and build strategies in plain English directly from your favorite LLM tools and IDEsMCP ServersJul 2026
- finopsmcpSee where your cloud and AI bills go, and spend less. Runs in your terminal or inside Claude, Cursor, and VS Code. Open source, local-first.MCP ServersJul 2026
- tradingview-mcpTradingView MCP server — real-time market data, technical analysis, screeners & backtesting for Claude, ChatGPT, Cursor & any MCP client. Stocks, crypto, forex & futures across global exchanges. Hosted or self-host.MCP ServersJul 2026
