🆕 最新版本(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令牌：

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.3.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) - 移动平均线

核心技术优势

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成分股区间摘要"

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

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

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

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

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

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

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

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

🔧 本地部署（Streamable HTTP）

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

环境要求

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

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/FinanceMCP --client claude

💡 提示：FinanceMCP 支持两种部署模式

• 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

启动服务

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

⭐ 推荐配置：stdio 模式（本地使用，零配置，默认）

🎯 方式一：全局安装后直接使用（最稳定，强烈推荐！）

# 第一步：全局安装
npm install -g finance-mcp

{
  "mcpServers": {
    "finance-mcp": {
      "type": "stdio",
      "command": "finance-mcp",
      "args": [],
      "env": {
        "TUSHARE_TOKEN": "your_tushare_token_here"
      }
    }
  }
}

为什么推荐这种方式？

• ✅ 最稳定 - 避免 npx 在不同系统上的兼容性问题
• ✅ 启动更快 - 无需每次下载和解析包
• ✅ Windows友好 - 避免 npx vs npx.cmd 的问题
• ✅ 离线可用 - 安装后无需网络连接

📦 方式二：使用 npx（无需安装）

{
  "mcpServers": {
    "finance-mcp": {
      "command": "npx",
      "args": ["-y", "finance-mcp"],
      "env": {
        "TUSHARE_TOKEN": "your_tushare_token_here"
      }
    }
  }
}

⚠️ Windows 用户注意：如果上述配置不工作，请尝试将 "command": "npx" 改为 "command": "npx.cmd"

stdio 模式优势：

• ✅ 更快的响应速度（1-2ms 延迟）
• ✅ 更低的资源占用
• ✅ 无需管理端口
• ✅ 开箱即用

🔧 常见问题排查

1. 确保已安装 Node.js (版本 >= 18)

   node -v  # 检查版本
   

2. Windows 用户：使用 npx.cmd 替代 npx

   {
     "command": "npx.cmd",
     "args": ["-y", "finance-mcp"]
   }
   

3. 推荐：全局安装后使用

   npm install -g finance-mcp
   

   然后配置 "command": "finance-mcp"

4. 检查 TUSHARE_TOKEN 是否正确填写

5. 重启 Claude Desktop 或 MCP 客户端

6. 查看日志：

   • Windows: %APPDATA%\Claude\logs
   • macOS: ~/Library/Logs/Claude

备选配置：HTTP 模式（云端部署或需要远程访问）

步骤 1：启动 HTTP 服务器

# 方式 1：使用 npx
npx -y finance-mcp-http

# 方式 2：全局安装后启动
npm install -g finance-mcp
finance-mcp-http

# 方式 3：本地开发
npm run start:http

步骤 2：配置 Claude Desktop

{
  "mcpServers": {
    "finance-mcp-http": {
      "type": "streamableHttp",
      "url": "http://localhost:3000/mcp",
      "timeout": 600,
      "headers": {
        "X-Tushare-Token": "your_tushare_token_here"
      }
    }
  }
}

HTTP 模式优势：

• ✅ 支持远程访问
• ✅ 支持多客户端同时连接
• ✅ 完整的 HTTP 日志（参考 LOGGING_GUIDE.md）
• ✅ 便于部署到 Smithery 等云平台