FinanceMCP

FinanceMCP 财经数据服务器

欢迎使用 FinanceMCP 财经数据服务器！本项目提供一个基于模型上下文协议 (MCP) 的服务器，使语言模型（如 Claude）能够访问通过 Tushare API 获取的实时财经数据。这使得AI助手能够基于最新的市场信息进行财经分析和预测。

🌟 功能特性

📈 股票数据查询

获取指定股票代码的历史行情数据，支持：

• A股（沪深两市）- 如平安银行(000001.SZ)
• 美股（纳斯达克、纽交所等）- 如苹果(AAPL)
• 港股（香港联交所）- 如腾讯控股(00700.HK)
• 外汇（主要货币对）- 如美元人民币(USDCNY)
• 期货（商品期货、金融期货等）- 如铜期货(CU2501.SHF)
• 基金（ETF、LOF等）- 如沪深300ETF(159919.SZ)
• 债券逆回购（国债、企业债等）- 如GC001(204001.SH)
• 可转债（含转股价值、转股溢价率等）- 如平银转债(113008.SH)
• 期权（含各类股票、指数期权）- 如50ETF期权(10001313.SH)

📊 指数数据查询

获取如上证指数、深证成指等主要市场指数的数据

📰 财经新闻获取

从多个来源（如新浪财经、东方财富、华尔街见闻、同花顺等）获取最新财经新闻

🏢 公司财务表现分析

获取上市公司全面的财务数据，包括：

• 利润表（营业收入、净利润、毛利率等）
• 资产负债表（总资产、负债、股东权益等）
• 现金流量表（经营、投资、筹资活动现金流）
• 业绩预告（净利润变动预测、业绩预告类型）
• 业绩快报（快速财务数据、同比增长率）
• 财务指标（ROE、ROA、流动比率、资产负债率等）
• 分红送股（现金分红、送股转股比例、重要日期）

🏦 基金数据全方位查询 ⭐️ 新功能

• 基金列表（基金基本信息、投资类型、管理费等）
• 基金管理人（基金公司信息、成立时间、注册资本等）
• 基金经理（基金经理履历、任职时间、管理基金等）
• 基金净值（单位净值、累计净值、复权净值等）
• 基金分红（分红方案、现金分红、除息日等）
• 基金持仓（重仓股票、持仓市值、持股比例等）

📈 宏观经济数据

获取以下宏观经济指标数据：

• Shibor利率（上海银行间同业拆放利率）
• LPR利率（贷款基础利率）
• GDP（国内生产总值）
• CPI（居民消费价格指数）
• PPI（工业品出厂价格指数）
• 货币供应量（M0、M1、M2）
• PMI采购经理指数（制造业、服务业、综合）
• 社会融资规模增量
• Shibor银行报价数据（买价、卖价）
• Libor利率（伦敦银行间同业拆放利率）
• Hibor利率（香港银行间同业拆放利率）

🤖 MCP 集成

与支持MCP的客户端（如Claude）无缝集成，实现智能财经分析

🚦 环境要求

在开始使用前，请确保您已安装：

1. Node.js 和 npm：
   • 要求 Node.js 版本 >= 18
   • 从 nodejs.org 下载安装
2. Tushare API Token：
   • 访问 tushare.pro 注册并获取API Token
   • 此Token将用于访问Tushare提供的金融数据
   • 注意：部分高级数据需要积分权限

🛠️ 安装与设置

通过 Smithery 安装 (推荐)

如果您使用Claude Desktop，可以通过Smithery快速安装：

手动安装

1. 获取代码：
   git clone https://github.com/guangxiangdebizi/FinanceMCP.git cd FinanceMCP
2. 安装依赖：
   npm install
3. 配置 Tushare API Token：
   • 创建.env文件在项目根目录
   • 添加以下内容：
     TUSHARE_TOKEN=您的Tushare_API_Token
   • 或直接在src/config.ts文件中设置
4. 构建项目：
   npm run build

🚀 运行服务器

启动服务器有两种方式：

方式1：使用 stdio 模式 (直接运行)

方式2：使用 Supergateway (推荐用于开发)

📝 配置MCP客户端

要在Claude或其他MCP客户端中使用此服务器，需要进行以下配置：

Claude配置

在Claude的配置文件中添加以下内容：

如果直接使用stdio模式（不使用Supergateway），则配置如下：

💡 使用示例

以下是使用FinanceMCP服务器的一些示例查询：

1. 查询股票数据

您可以向Claude提问：

A股查询：

"查询平安银行(000001.SZ)最近30天的股价数据"

美股查询：

"查询苹果公司(AAPL)最近一个月的股价数据"

港股查询：

"查询腾讯控股(00700.HK)最近的股价表现"

外汇查询：

"查询美元人民币(USDCNY)最近的汇率走势"

期货查询：

"查询铜期货(CU2501.SHF)最近的行情数据"

基金查询：

"查询沪深300ETF(159919.SZ)最近的净值表现"

债券逆回购查询：

"查询GC001国债逆回购(204001.SH)最近的利率走势"

可转债查询：

"查询平银转债(113008.SH)最近的行情数据"

期权查询：

"查询50ETF期权(10001313.SH)最近的行情数据"

这将使用stock_data工具获取相应市场的股票数据。

2. 获取财经新闻

您可以向Claude提问：

"获取最新的10条财经新闻"

这将使用finance_news工具获取最新新闻。

3. 查询宏观经济数据

您可以向Claude提问：

"查询最近两年的GDP数据"

这将使用macro_econ工具获取GDP数据。

4. 查询公司财务表现

您可以向Claude提问：

查询单一财务数据：

"查询平安银行(000001.SZ)最近的利润表数据" "查询腾讯控股(00700.HK)的资产负债表" "查询苹果公司(AAPL)的现金流量表"

查询业绩预告和快报：

"查询贵州茅台(600519.SH)的业绩预告" "查询比亚迪(002594.SZ)的业绩快报"

查询财务指标：

"查询招商银行(600036.SH)的财务指标，包括ROE、ROA等"

查询分红送股：

"查询中国平安(601318.SH)的分红送股历史"

查询全部财务数据：

"查询万科A(000002.SZ)的全部财务表现数据"

这将使用company_performance工具获取相应的财务数据。

5. 查询基金数据 ⭐️ 新功能

您可以向Claude提问：

查询基金基本信息：

"查询沪深300ETF(159919.SZ)的基本信息" "查询场内的所有ETF基金"

查询基金净值：

"查询易方达蓝筹精选(005827.OF)最近的净值走势" "查询华夏沪深300ETF的净值表现"

查询基金持仓：

"查询招商中证白酒指数基金的重仓股票" "查询南方中证500ETF的持仓明细"

查询基金分红：

"查询富国天惠精选成长基金的分红历史"

查询基金经理：

"查询张坤管理的基金" "查询易方达基金的基金经理信息"

查询基金管理人：

"查询易方达基金管理有限公司的详细信息"

查询全部基金数据：

"查询华夏沪深300ETF(510330.SH)的全部数据"

这将使用fund_data工具获取相应的基金数据。

6. 结合数据进行分析

您可以向Claude提问更复杂的问题：

"结合最近的新闻和股价数据，分析平安银行(000001.SZ)的投资前景"

Claude将调用多个工具获取所需数据，然后基于这些数据提供分析。

📊 支持的数据接口

目前项目已接入以下Tushare API接口：

🔮 未来计划

未来计划接入更多Tushare数据接口，包括但不限于：

1. 基础数据：股票列表、交易日历、停复牌信息等
2. 更多财务数据：财务审计意见、主营业务构成、股东信息等
3. 基金数据：基金净值、基金持仓、基金经理信息等
4. 更多新闻数据：公告信息、长篇财经新闻、研报数据等
5. 技术分析指标：MACD、RSI、布林带等技术指标
6. 行业数据：行业分类、行业指数、行业对比分析等

详见tushare-interfaces.md文件，其中列出了更多可能接入的数据接口。

📄 许可证

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

👨‍💻 作者

• 名称: Xingyu_Chen
• 邮箱: guangxiangdebizi@gmail.com
• GitHub: guangxiangdebizi