Stonks (Pbonmars 20031006)

股票新闻自动化服务

一个智能的MCP（模型上下文协议）服务器，使用人工智能提供的见解在谷歌表格中自动进行股票分析和新闻更新。

🚀 特性

核心能力

• Google表格集成：无缝连接到您的谷歌表格，进行实时股票数据管理
• AI驱动的分析：使用Google Gemini生成全面的股票分析
• 多类型分析：支持5种不同的分析类型，实现全面覆盖
• 机构数据可视化：为机构所有权数据创建图表
• 自动新闻更新：获取并总结最新股票新闻

可用的分析类型

1. 📰 新闻分析+市场背景 （D列）

- 公司特定新闻和收益 - 更广泛的市场趋势和经济因素 - 地缘政治影响和行业颠覆

1. 🤖 AI驱动的洞察 （E栏）

- 预测建模与模式识别 - 带有概率评估的情景分析 - 市场时机指标

1. 📊 投资者洞察 （F栏）

- 技术和基本面分析 - 风险评估和竞争分析 - 行业动态和催化剂日历

1. 💰 快速财务概述 （G栏）

- 关键财务指标和比率 - 增长率和盈利能力分析 - 流动性和估值指标

1. 🏢 机构信息 （H栏）

- 机构所有权数据 - 对冲基金和共同基金活动 - 内幕交易和分析师报道

🛠️ 安装说明

先决条件

• Python 3.8+
• 谷歌云控制台帐户
• Google Sheets API访问

1.Google Sheets API设置

按照Google官方指南设置API访问权限： Google Sheets API Quickstart

2.安装

# Clone the repository
git clone 
cd stocks

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

# Install dependencies
pip install -r requirements.txt

3.配置

1. 下载 credentials.json 从谷歌云控制台
2. 将其放置在项目根目录中
3. 创建 .env 文件包含：

GOOGLE_API_KEY=your_gemini_api_key
SPREADSHEET_ID=your_google_sheets_id
RANGE_NAME=Sheet1!A6:C9

4.使用方法

选项A：独立模式

# Start the MCP Server
python server.py

# Run the Client
python client.py server.py

选项B:MCP客户端集成

添加到MCP客户端配置中：

{
  "mcpServers": {
    "stonks-server": {
      "command": "path to your python bin",
      "args": ["path to server.py"]
    }
  }
}

备注：更新路径以匹配您的实际安装目录。

🎯 运作原理

1. 初始化：使用Google Sheets API进行身份验证
2. 获取股票：从电子表格中检索股票数据
3. 分析：为每只股票生成人工智能分析
4. 更新：在指定列中自动填充分析
5. 可视化：创建机构所有权图表

📋 可用的MCP工具

• initialize()：设置Google表格身份验证
• get_stocks()：从电子表格中获取股票数据
• update()：向具有多种分析类型的特定单元格添加分析
• search_news()：使用Gemini AI生成新闻摘要
• plot_institutional_chart()：创建所有权可视化图表

这些工具可以通过任何兼容MCP的客户端（Claude Desktop等）获得

🔧 技术架构

• MCP服务器：用于工具编排的FastMCP框架
• 人工智能集成：用于智能分析的Google Gemini
• 数据可视化：Matplotlib用于机构图表
• 认证：OAuth2用于安全访问Google表格
• 客户端接口：LangGraph与React代理用于自然语言交互

📊 示例工作流

User: "Update all stocks with latest news and analysis"
↓
Agent: 
1. Initializes Google Sheets connection
2. Retrieves stock symbols from spreadsheet
3. Generates news analysis for each stock
4. Updates respective columns with AI insights
5. Creates institutional ownership charts

🚨 重要提示

• 分析基于过去10天的数据
• 包括对SeekingAlpha、TradingTerminal和TradingView的引用
• 非财务建议-仅供参考
• 需要有效的Google API证书

📈 未来的增强功能

• 实时数据集成
• 高级图表功能
• 投资组合绩效跟踪
• 自定义分析模板
• 多交换支持

______________________________________________________________________

安装指南: Google Sheets API Quickstart