内容
# 股票新闻自动化服务
一款智能的MCP（模型上下文协议）服务器，利用人工智能驱动的洞察力，在Google Sheets中自动进行股票分析和新闻更新。
## 🚀 功能特点
### 核心能力
- **Google Sheets集成**: 与您的Google Sheets无缝连接，实现实时股票数据管理
- **人工智能驱动的分析**: 使用Google Gemini生成全面的股票分析
- **多种类型分析**: 支持5种不同的分析类型，实现全面覆盖
- **机构数据可视化**: 创建机构所有权数据的图表
- **自动新闻更新**: 获取并总结最新的股票新闻
### 可用分析类型
1. **📰 新闻分析 + 市场背景** (列 D)
- 公司特定新闻和收益
- 更广泛的市场趋势和经济因素
- 地缘政治影响和行业颠覆
2. **🤖 人工智能驱动的洞察** (列 E)
- 预测建模和模式识别
- 场景分析与概率评估
- 市场时机指标
3. **📊 投资者洞察** (列 F)
- 技术和基本面分析
- 风险评估和竞争分析
- 行业动态和催化剂日历
4. **💰 快速财务概览** (列 G)
- 关键财务指标和比率
- 增长率和盈利能力分析
- 流动性和估值指标
5. **🏢 机构信息** (列 H)
- 机构所有权数据
- 对冲基金和共同基金活动
- 内幕交易和分析师覆盖
## 🛠️ 设置说明
### 先决条件
- Python 3.8+
- Google Cloud Console账户
- Google Sheets API访问权限
### 1. Google Sheets API设置
按照官方Google指南设置API访问权限：
**[Google Sheets API快速入门](https://developers.google.com/workspace/sheets/api/quickstart/python)**
### 2. 安装
```bash
# 克隆仓库
git clone <您的仓库网址>
cd stocks
# 创建虚拟环境
python -m venv stocks
source stocks/bin/activate # 在Windows上：stocks\Scripts\activate
# 安装依赖项
pip install -r requirements.txt
```
### 3. 配置
1. 从Google Cloud Console下载`credentials.json`
2. 将其放在项目根目录中
3. 创建`.env`文件，内容如下：
```env
GOOGLE_API_KEY=您的gemini_api_key
SPREADSHEET_ID=您的google_sheets_id
RANGE_NAME=Sheet1!A6:C9
```
### 4. 使用
#### 选项A：独立模式
```bash
# 启动MCP服务器
python server.py
# 运行客户端
python client.py server.py
```
#### 选项B：MCP客户端集成
将以下内容添加到您的MCP客户端配置中：
```json
{
"mcpServers": {
"stonks-server": {
"command": "路径到您的python可执行文件",
"args": ["路径到server.py"]
}
}
}
```
**注意**：更新路径以匹配您的实际安装目录。
## 🎯 工作原理
1. **初始化**：与Google Sheets API进行身份验证
2. **获取股票**：从电子表格中检索股票数据
3. **分析**：为每只股票生成人工智能驱动的分析
4. **更新**：在指定列中自动填充分析
5. **可视化**：创建机构所有权图表
## 📋 可用的MCP工具
- **`initialize()`**：设置Google Sheets身份验证
- **`get_stocks()`**：从电子表格中获取股票数据
- **`update()`**：使用多种分析类型将分析添加到特定单元格
- **`search_news()`**：使用Gemini AI生成新闻摘要
- **`plot_institutional_chart()`**：创建所有权可视化图表
这些工具可通过任何MCP兼容的客户端（Claude Desktop等）使用。
## 🔧 技术架构
- **MCP服务器**：FastMCP框架用于工具编排
- **AI集成**：Google Gemini用于智能分析
- **数据可视化**：Matplotlib用于机构图表
- **身份验证**：OAuth2用于安全的Google Sheets访问
- **客户端接口**：LangGraph与React代理用于自然语言交互
## 📊 示例工作流程
```
用户：“用最新的新闻和分析更新所有股票”
↓
代理：
1. 初始化Google Sheets连接
2. 从电子表格中检索股票代码
3. 为每只股票生成新闻分析
4. 用AI洞察更新相应列
5. 创建机构所有权图表
```
## 🚨 重要注意事项
- 分析基于最近10天的数据
- 包含对SeekingAlpha、TradingTerminal和TradingView的引用
- 不作为财务建议 - 仅供信息目的
- 需要有效的Google API凭证
## 📈 未来增强功能
- 实时数据集成
- 高级图表功能
- 投资组合绩效跟踪
- 自定义分析模板
- 多交易所支持
---
**设置指南**：[Google Sheets API快速入门](https://developers.google.com/workspace/sheets/api/quickstart/python)
