投资者助手开源项目最佳实践

1. 项目介绍

投资者助手（Investor-Agent）是一个基于Model Context Protocol（MCP）的服务器，它为大型语言模型提供全面的财务洞察和分析。该服务器利用实时市场数据、基本面和技术分析，帮助用户获取以下信息：

• 详细股票报告，包括公司概述、新闻、关键指标、表现、日期、分析师推荐以及评级升级/降级。
• 显示高持仓量的期权数据。
• 股票的历史价格趋势。
• 必要的财务报表（收入、资产负债表、现金流量）。
• 实时机构持股和共同基金持仓。
• 收益历史和内部交易活动。
• 当前和历史的CNN恐惧与贪婪指数数据及趋势分析。
• 技术指标计算（SMA、EMA、RSI、MACD、BBANDS）。
• 与核心投资原则和投资组合构建策略相关的提示。

2. 项目快速启动

要快速启动投资者助手项目，请按照以下步骤操作：

首先，确保你的系统安装了Python 3.12或更高版本。然后，安装uv包管理器：

curl -LsSf https://astral.sh/uv/install.sh | sh

接下来，你可以使用uvx命令来运行投资者助手项目，而不需要全局或特定环境中安装它：

# 只运行核心功能
uvx investor-agent

# 如果你需要计算技术指标工具（并且已经安装了TA-Lib C库），可以包括可选依赖项：
uvx "investor-agent[ta]"

注意：使用uvx "package[extra]"需要一个较新版本的uv（0.7.0或更高版本）。使用uvx与[ta]需要预先正确安装并在系统中找到TA-Lib C库。

3. 应用案例和最佳实践

以下是一些使用投资者助手项目的最佳实践：

• 数据缓存：为了提高性能并减少冗余API调用，项目会自动缓存yfinance API响应到一个本地的yfinance.cache文件中，缓存时间为一小时。
• 交易自动化：结合MCP服务器和经纪平台（如tastytrade）的tasty-agent进行自动交易。
• 新闻整合：如果需要将最新新闻整合到分析中，请确保启用网络搜索功能。

4. 典型生态项目

投资者助手项目可以与以下生态项目结合使用，以增强其功能：

• yfinance：用于检索市场数据。
• tasty-agent：用于在tastytrade平台上进行交易。
• TA-Lib：提供技术分析指标的计算。

通过遵循上述最佳实践，开发者可以有效地利用投资者助手项目来增强他们的财务分析能力。