investor-agent: A Financial Analysis MCP Server

investor-agent: A Financial Analysis MCP Server

site icon
2025.04.04 66
Python金融分析市场数据投资工具金融服务
investor-agent 是一个基于 Model Context Protocol (MCP) 的金融分析服务器,旨在为大型语言模型提供全面的金融洞察和分析。它利用实时市场数据、新闻和高级分析工具,帮助用户获取详细的股票报告、期权数据、历史价格趋势、财务报表、机构持股信息、收益历史和内幕交易活动等。该服务器与 yfinance 集成,用于市场数据检索,并可与其他 MCP 服务器(如 tasty-agent)结合使用,实现交易功能。
View on GitHub

Overview

基本能力

产品定位

investor-agent 是一个金融分析工具,专注于为投资者和金融分析师提供实时的市场数据和深度分析。

核心功能

  1. 股票信息获取
  2. 获取股票的综合报告(公司概况、新闻、关键指标、表现、日期、分析师推荐等)。
  3. 获取高开仓兴趣的期权数据。
  4. 获取股票的历史价格数据。

  5. 财务数据工具

  6. 获取财务报表(收入、资产负债表、现金流量表)。
  7. 获取机构持股和共同基金持股信息。
  8. 获取收益历史和内幕交易活动。

  9. 集成能力

  10. 与 yfinance 集成,支持实时市场数据检索。
  11. 可与其他 MCP 服务器(如 tasty-agent)结合使用,实现交易功能。

适用场景

  1. 投资分析:帮助投资者快速获取股票和期权数据,辅助决策。
  2. 金融研究:为研究人员提供历史价格和财务数据支持。
  3. 自动化交易:结合其他 MCP 服务器实现自动化交易。

工具列表

  1. get_ticker_data:获取股票的综合报告。
  2. get_available_options:获取高开仓兴趣的期权数据。
  3. get_price_history:获取股票的历史价格数据。
  4. get_financial_statements:获取财务报表。
  5. get_institutional_holders:获取机构持股信息。
  6. get_earnings_history:获取收益历史。
  7. get_insider_trades:获取内幕交易活动。

常见问题解答

  1. 如何安装?:需安装 Python 3.12 或更高版本,并使用 uv 包管理器。
  2. 如何调试?:使用 MCP inspector 进行调试,日志文件位于 macOS 的 ~/Library/Logs/Claude/mcp*.log 或 Windows 的 %APPDATA%\Claude\logs\mcp*.log
  3. 如何集成?:通过配置 MCP 客户端(如 Claude Desktop)的 JSON 文件实现集成。

使用教程

使用依赖

  1. Python:3.12 或更高版本。
  2. 包管理器:uv。

安装教程

  1. 安装 uv: bash curl -LsSf https://astral.sh/uv/install.sh | sh
  2. 运行 investor-agent: bash uvx investor-agent

调试方式

  1. 使用 MCP inspector 调试: bash npx @modelcontextprotocol/inspector uvx investor-agent
  2. 检查日志文件:
  3. macOS:~/Library/Logs/Claude/mcp*.log
  4. Windows:%APPDATA%\Claude\logs\mcp*.log

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。