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

环境要求

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

安装步骤

方法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 延迟）
• ✅ 更低的资源占用
• ✅ 无需管理端口
• ✅ 开箱即用

🔧 常见问题排查

备选配置：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 等云平台

传递 Token 的方式

• stdio 模式：通过 env.TUSHARE_TOKEN 环境变量
• HTTP 模式：
  • 优先从 X-Tushare-Token Header 读取
  • 或使用 Authorization: Bearer <token>
  • 或使用 X-Api-Key
  • 最后回退到环境变量 TUSHARE_TOKEN

（加密市场默认使用 Binance 公共行情接口，无需任何加密货币 API Key）

📖 详细文档：更多部署模式说明请参考 DEPLOYMENT_MODES.md

验证安装

配置完成后，重启Claude桌面版并询问："获取当前时间"。如果返回时间信息，说明安装成功。

• 💹 个股接口切换：money_flow 工具的个股数据源由东财试用接口 moneyflow_dc 切换为 Tushare 标准接口 moneyflow（2000 积分即可正式调取），彻底解决高积分 Token 仍被限制"每天 2 次"的问题。字段做兼容映射：主力净额使用 net_mf_amount，各档净额按"买入-卖出"计算，量纲统一为元。
• ⚠️ 大盘 / 板块：Tushare 无非 DC 替代接口，仍使用 moneyflow_mkt_dc / moneyflow_ind_dc。遇到积分不足导致的限流，会返回清晰的"访问受限 + 去 tushare.pro 查看积分"提示，不再是晦涩的原始错误。
• 📝 工具 description & 参数示例同步：明确三类接口名称、积分门槛与字段缺失情况；板块代码示例从 BK0447 修正为 BK0486.DC（带 .DC 后缀，避免查询返回 0 条）。
• 📋 个股表格增加提示：说明 收盘价 / 涨跌% / 净占比% 因接口不返回而显示 N/A 属正常现象。

• 🛠️ 协议兼容修复：新增 resources/templates/list 方法处理，返回空模板列表，避免 Streamable HTTP 初始化报错。
• ✅ 部署更稳定：兼容会主动探测 resources/templates/list 的 MCP 客户端配置。

• 📊 板块资金流向：支持查询东方财富(DC)行业、概念、地域板块资金流向
• 🎲 智能识别：自动识别查询类型（个股/大盘/板块），BK开头代码自动识别为板块
• 📈 多维度分析：板块涨跌幅、资金流入排名、超大单/大单/中单/小单明细
• 🔍 灵活查询：支持按板块代码、交易日期、板块类型（行业/概念/地域）查询
• 📋 完整展示：板块基本信息、统计摘要、明细表格、资金流向趋势

使用示例：

// 查询特定板块资金流向
{
  "ts_code": "BK0486.DC",  // 东财板块代码（带 .DC 后缀）
  "start_date": "20240901",
  "end_date": "20240930"
}

// 查询某日所有行业板块资金流向
{
  "query_type": "sector",
  "trade_date": "20240927",
  "content_type": "行业",
  "start_date": "20240927",
  "end_date": "20240927"
}

API集成：基于 Tushare 东财板块资金流向API（moneyflow_ind_dc）

• ⏱ 分钟K线增强：stock_data_minutes 新增 market_type（cn/crypto），支持 Binance 分钟线
• 🪙 加密分钟线：兼容 BTCUSDT/BTC-USDT/BTC/USDT/coinid.USDT；频率映射 1MIN/5MIN/15MIN/30MIN/60MIN → 1m/5m/15m/30m/1h
• 📦 自动分页：Binance 单次最多1000根K线，自动分页直至覆盖完整区间
• 🧭 智能扩展取数（日线）：请求技术指标时自动扩展开始日期，保证计算窗口足够
• 🧩 友好错误提示：无效交易对返回 400 时，明确提示“该币对在 Binance 不存在或已下线”
• 📈 A股前复权（日线）：自动应用前复权（基于最新交易日因子）

其他能力保持不变：Web在线体验、NPM 包、Streamable HTTP、稳定会话管理等。

迁移指南：升级到 v4.3.0 后，分钟线新增必填 market_type：A股传 cn，加密传 crypto。

• 🇺🇸 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，完整数据格式优化。