首页/金融与金融科技/investor-agent

investor-agent

查看源码
ferdousbhai
2025-5-12
Words 1511Read Time≈ 4 min
Score:85

提供实时市场数据和财务分析，帮助大语言模型进行投资决策的MCP服务器。

MCP服务器
Python

investor-agent: 金融分析 MCP 服务器

概述

investor-agent 是一个基于模型上下文协议（Model Context Protocol, MCP）的服务器，旨在为大型语言模型提供全面的金融洞察和分析。它利用实时市场数据、新闻和高级分析工具，帮助用户获取以下信息：
  • 详细的股票报告：包括公司概况、新闻、关键指标、业绩、日期、分析师推荐以及评级升级/降级。
  • 期权数据：突出显示高未平仓合约的期权。
  • 股票历史价格趋势。
  • 核心财务报表（损益表、资产负债表、现金流量表），以百万美元为单位格式化。
  • 最新的机构持股和共同基金持仓。
  • 当前和历史 CNN 恐惧与贪婪指数数据及其趋势分析。
  • 与核心投资原则和投资组合构建策略相关的提示。
  • 收益历史和内部交易活动。
该服务器集成了 yfinance 用于市场数据获取，并从 CNN 获取恐惧与贪婪指数数据。
您可以将其与用于在经纪平台（如 tasty-agent）上执行交易的 MCP 服务器结合使用，以在 tastytrade 平台上进行交易。如果您希望在分析中纳入最新新闻，请确保启用网络搜索功能。

先决条件

  • Python: 3.12 或更高版本
  • 包管理器: uv

安装

首先，如果尚未安装 uv，请执行以下命令：
然后，您可以使用 uvx 运行 investor-agent MCP 服务器：

工具

investor-agent 服务器提供了多种工具以支持金融分析：

股票信息

  1. get_ticker_data
      • 描述: 获取指定股票代码的详细报告，包括公司概况、新闻、关键指标、业绩、日期、分析师推荐以及评级升级/降级。
      • 输入:
        • ticker (字符串): 股票代码（例如 "AAPL"）。
      • 返回: 一个格式化的多部分报告。
  1. get_available_options
      • 描述: 提供具有最高未平仓合约的股票期权列表。
      • 输入:
        • ticker_symbol (字符串): 股票代码。
        • num_options (整数, 可选): 返回的期权数量（默认: 10）。
        • start_date 和 end_date (字符串, 可选): 日期范围，格式为 YYYY-MM-DD。
        • strike_lower 和 strike_upper (浮点数, 可选): 期望的行权价范围。
        • option_type (字符串, 可选): 期权类型（"C" 表示看涨期权，"P" 表示看跌期权）。
      • 返回: 一个格式化的期权数据表。
  1. get_price_history
      • 描述: 获取指定股票的历史价格数据。
      • 输入:
        • ticker (字符串): 股票代码。
        • period (字符串): 时间周期（可选值: "1d", "5d", "1mo", "3mo", "6mo", "1y", "2y", "5y", "10y", "ytd", "max"）。
      • 返回: 显示价格历史的表格。

财务数据工具

  1. get_financial_statements
      • 描述: 获取财务报表（损益表、资产负债表或现金流量表），以百万美元为单位格式化。
      • 输入:
        • ticker (字符串): 股票代码。
        • statement_type (字符串): "income", "balance", 或 "cash"。
        • frequency (字符串): "quarterly" 或 "annual"。
      • 返回: 一个格式化的财务报表。
  1. get_institutional_holders
      • 描述: 获取主要机构和共同基金持股者的详细信息。
      • 输入:
        • ticker (字符串): 股票代码。
      • 返回: 两个格式化表格，分别列出机构和共同基金持股者。
  1. get_earnings_history
      • 描述: 获取收益历史的格式化表格。
      • 输入:
        • ticker (字符串): 股票代码。
      • 返回: 显示历史收益数据的表格。
  1. get_insider_trades
      • 描述: 获取指定股票的近期内部交易活动。
      • 输入:
        • ticker (字符串): 股票代码。
      • 返回: 显示内部交易的格式化表格。

CNN 恐惧与贪婪指数工具

  1. get_current_fng_tool
      • 描述: 获取当前的 CNN 恐惧与贪婪指数得分、评级和分类。
      • 输入: 无
      • 返回: 包含当前指数详情的字符串。
  1. get_historical_fng_tool
      • 描述: 获取指定天数的历史 CNN 恐惧与贪婪指数数据。
      • 输入:
        • days (整数): 要检索的历史数据天数。
      • 返回: 列出历史得分和分类的字符串。
  1. analyze_fng_trend
      • 描述: 分析指定天数内 CNN 恐惧与贪婪指数的趋势。
      • 输入:
        • days (整数): 趋势分析中包含的天数。
      • 返回: 包含最新值、平均值、范围、趋势方向和分类的摘要字符串。

信息提示

  1. investment_principles
      • 描述: 提供一组核心投资原则和指南。
      • 输入: 无
      • 返回: 概述多项投资原则的字符串。
  1. portfolio_construction_prompt
      • 描述: 概述一种包含尾部对冲的投资组合构建策略。
      • 输入: 无
      • 返回: 指导构建对冲投资组合的详细提示。

与 MCP 客户端集成

要将 investor-agent 与 MCP 客户端（例如 Claude Desktop）集成，请将以下配置添加到您的 claude_desktop_config.json 文件中：

调试

您可以使用 MCP 检查器调试服务器：
日志监控请检查以下目录：
  • macOS: ~/Library/Logs/Claude/mcp*.log
  • Windows: %APPDATA%\Claude\logs\mcp*.log

开发

本地开发和测试：
  1. 使用 MCP 检查器，如 调试 部分所述。
  1. 使用以下配置在 Claude Desktop 中进行测试：

许可证

本 MCP 服务器遵循 MIT 许可证。详情请参阅 LICENSE 文件。
上一篇
sanity-mcp-server
下一篇
mcp-demo
Catalog