
investor-agent: A Financial Analysis MCP Server

2025.04.04
66
Python金融分析市场数据投资工具金融服务
investor-agent 是一个基于 Model Context Protocol (MCP) 的金融分析服务器,旨在为大型语言模型提供全面的金融洞察和分析。它利用实时市场数据、新闻和高级分析工具,帮助用户获取详细的股票报告、期权数据、历史价格趋势、财务报表、机构持股信息、收益历史和内幕交易活动等。该服务器与 yfinance 集成,用于市场数据检索,并可与其他 MCP 服务器(如 tasty-agent)结合使用,实现交易功能。
View on GitHub
Overview
基本能力
产品定位
investor-agent 是一个金融分析工具,专注于为投资者和金融分析师提供实时的市场数据和深度分析。
核心功能
- 股票信息获取:
- 获取股票的综合报告(公司概况、新闻、关键指标、表现、日期、分析师推荐等)。
- 获取高开仓兴趣的期权数据。
-
获取股票的历史价格数据。
-
财务数据工具:
- 获取财务报表(收入、资产负债表、现金流量表)。
- 获取机构持股和共同基金持股信息。
-
获取收益历史和内幕交易活动。
-
集成能力:
- 与 yfinance 集成,支持实时市场数据检索。
- 可与其他 MCP 服务器(如 tasty-agent)结合使用,实现交易功能。
适用场景
- 投资分析:帮助投资者快速获取股票和期权数据,辅助决策。
- 金融研究:为研究人员提供历史价格和财务数据支持。
- 自动化交易:结合其他 MCP 服务器实现自动化交易。
工具列表
get_ticker_data
:获取股票的综合报告。get_available_options
:获取高开仓兴趣的期权数据。get_price_history
:获取股票的历史价格数据。get_financial_statements
:获取财务报表。get_institutional_holders
:获取机构持股信息。get_earnings_history
:获取收益历史。get_insider_trades
:获取内幕交易活动。
常见问题解答
- 如何安装?:需安装 Python 3.12 或更高版本,并使用 uv 包管理器。
- 如何调试?:使用 MCP inspector 进行调试,日志文件位于 macOS 的
~/Library/Logs/Claude/mcp*.log
或 Windows 的%APPDATA%\Claude\logs\mcp*.log
。 - 如何集成?:通过配置 MCP 客户端(如 Claude Desktop)的 JSON 文件实现集成。
使用教程
使用依赖
- Python:3.12 或更高版本。
- 包管理器:uv。
安装教程
- 安装 uv:
bash curl -LsSf https://astral.sh/uv/install.sh | sh
- 运行 investor-agent:
bash uvx investor-agent
调试方式
- 使用 MCP inspector 调试:
bash npx @modelcontextprotocol/inspector uvx investor-agent
- 检查日志文件:
- macOS:
~/Library/Logs/Claude/mcp*.log
- Windows:
%APPDATA%\Claude\logs\mcp*.log