📈 Finance MCP Server

📈 Finance MCP Server

一款功能强大的 Model Context Protocol（MCP）服务，为 Claude Desktop 和其他兼容 MCP 的客户端提供全面的股票市场数据和技术分析功能。

🚀 功能

• 📊 股票信息：完整的公司概况、市场指标和关键统计数据
• 📈 历史数据：可自定义时间范围的历史价格数据
• ⚡ 实时报价：实时股票价格及涨跌计算
• 🔧 技术指标：10 多种专业级技术分析工具
• 🚀 高性能：智能缓存系统，提升运行速度
• 🛡️ 稳健可靠：完善的错误处理和验证
• 🔌 轻松集成：一条命令即可安装到 Claude Desktop

📦 快速安装

Claude Desktop 用户

pip install finance-mcp-server

然后添加到 Claude Desktop 配置中：

{
  "mcpServers": {
    "finance": {
      "command": "finance-mcp-server"
    }
  }
}

重启 Claude Desktop，即可开始查询股票信息！🎉

手动安装

# Clone the repository
git clone https://github.com/akshatbindal/finance-mcp-server.git
cd finance-mcp-server

# Install in development mode
pip install -e .

# Or install from PyPI
pip install finance-mcp-server

🎯 使用示例

安装完成后，你可以用自然语言向 Claude Desktop 提问，例如：

• “Apple 当前的股价和市值是多少？”
• “展示 Tesla 过去 6 个月的表现”
• “计算 Microsoft 股票的 RSI 和 MACD”
• “比较 Google 和 Amazon 的 50 日移动平均线”
• “Netflix 目前的布林带指标是多少？”

🛠️ 可用工具

Finance MCP Server 通过 MCP 协议提供以下工具：

• get_comprehensive_stock_info：获取任意股票代码对应的公司、市场、财务和分析师详细数据。
• get_historical_data：获取可自定义周期和间隔的历史价格数据，包括拆股和股息信息。
• get_options_data：获取股票期权链数据，包括多个到期日的看涨期权和看跌期权。
• get_institutional_holders：查看股票的机构和主要持有人。
• get_earnings_calendar：查看财报日历、历史记录和分析师目标价。
• get_analyst_recommendations：获取分析师建议、评级上调和评级下调信息。
• get_financial_statements：下载完整的损益表、资产负债表和现金流量表（年度/季度）。
• get_news：获取股票的最新新闻标题和元数据。
• get_technical_analysis：获取专业指标（SMA、EMA、RSI、MACD、布林带、成交量、支撑位/阻力位等）。
• get_sector_performance：比较多只股票的表现、波动性和指标。
• get_dividend_history：查看股息支付历史、摘要和统计数据。

工具调用示例（MCP JSON）

{
  "tool": "get_comprehensive_stock_info",
  "arguments": {"symbol": "AAPL"}
}

缓存与性能

• 公司信息、新闻、期权、持有人、日历、建议：缓存 5–60 分钟
• 实时数据：缓存 1 分钟
• 基本面数据：缓存 10 分钟
• 优化的 yfinance 用法：启用多线程、批量请求和错误隔离

错误处理

• 所有端点在失败时都会返回明确的错误消息
• 对缺失或不完整的数据进行平稳回退处理
• 记录所有异常和警告

技术分析

• 移动平均线（SMA 20/50/200、EMA 12/26）
• RSI、MACD、布林带、成交量趋势
• 支撑位/阻力位、波动性等

扩展数据

• 期权链（看涨/看跌期权、OI、IV、最新交易）
• 机构/主要持有人
• 财报日历/历史记录、分析师目标价
• 完整财务报表（年度/季度）
• 新闻标题、发布方、相关股票代码
• 股息历史和摘要

🛠️ 配置

基本配置

{
  "mcpServers": {
    "finance": {
      "command": "finance-mcp-server"
    }
  }
}

高级配置

{
  "mcpServers": {
    "finance": {
      "command": "finance-mcp-server",
      "env": {
        "LOG_LEVEL": "INFO",
        "CACHE_DURATION": "300"
      }
    }
  }
}

🔧 开发

设置开发环境

# Clone the repository
git clone https://github.com/akshatbindal/finance-mcp-server.git
cd finance-mcp-server

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install in development mode
pip install -e .

# Install development dependencies
pip install pytest black flake8 mypy

# Run tests
pytest

# Format code
black finance_mcp/

# Type checking
mypy finance_mcp/

运行服务

# Run directly
python -m finance_mcp.server

# Or use the console script
finance-mcp-server

# With debug logging
LOG_LEVEL=DEBUG finance-mcp-server

📊 性能特性

智能缓存

• 股票信息和技术指标：缓存 5 分钟
• 实时数据：缓存 1 分钟
• 历史数据：基于会话缓存
• 自动使缓存失效

错误处理

• 妥善处理无效的股票代码
• 网络超时保护
• 全面的错误消息
• 数据检索回退机制

🔒 隐私与安全

• 不存储数据：所有数据均实时从 Yahoo Finance 获取
• 不跟踪用户：不收集或存储个人信息
• 速率限制：内置防止 API 滥用的保护机制
• 错误隔离：错误不会导致整个服务崩溃

🤝 参与贡献

欢迎参与贡献！你可以通过以下方式提供帮助：

1. 复刻代码仓库
2. 创建功能分支：git checkout -b feature/amazing-feature
3. 进行更改并添加测试
4. 运行测试套件：pytest
5. 格式化代码：black finance_mcp/
6. 提交拉取请求

可贡献的领域

• 更多技术指标
• 加密货币支持
• 期权和期货数据
• 新闻情绪集成
• 性能优化
• 文档改进

📋 要求

• Python：3.8 或更高版本
• 依赖项：
  • mcp >= 1.0.0 - Model Context Protocol 框架
  • yfinance >= 0.2.18 - Yahoo Finance API 封装
  • pandas >= 2.0.0 - 数据处理和分析
  • ta >= 0.10.2 - 技术分析库

🐛 故障排除

常见问题

服务无法启动？

# Check if all dependencies are installed
pip install -r requirements.txt

# Test the server manually
finance-mcp-server

没有某个代码的数据？

• 确认股票代码正确（例如，“AAPL”，而不是“Apple”）
• 检查市场是否开市（这会影响实时数据）
• 某些代码可能无法在 Yahoo Finance 上获取

Claude Desktop 无法连接？

• 确保配置 JSON 有效
• 检查命令路径是否正确
• 完全重启 Claude Desktop
• 检查 Claude Desktop 的日志，查看错误消息

获取帮助

• GitHub Issues：报告错误或请求功能
• 讨论区：获取社区支持并提出问题
• 文档：完整文档和示例

📄 许可证

本项目采用 Apache License 许可，详情请参阅 LICENSE 文件。

🙏 致谢

• Yahoo Finance：提供免费的金融数据
• MCP Team：提供 Model Context Protocol 框架
• 技术分析库的贡献者
• 开源社区：给予灵感和支持

🔮 路线图

版本 1.1.0（即将推出）

• 支持加密货币（Bitcoin、Ethereum 等）
• 期权链数据
• 集成财报日历
• 新闻情绪分析

版本 1.2.0（未来计划）

• 投资组合跟踪功能
• 自定义指标构建器
• 多时间周期分析
• 高级图表数据

版本 2.0.0（愿景）

• 机器学习预测
• 风险分析工具
• 回测框架
• 专业交易员功能

---

⭐ Star 历史

---

为 MCP 和交易社区倾心打造 ❤️

为对话式 AI 带来专业级金融分析