金融分析 MCP 服务器

一个强大的金融分析服务器，提供股票数据检索和可视化功能。

功能特性

• 从 yfinance 检索股票数据
• Alpha Vantage API 集成
• 网页搜索金融信息
• 使用 Plotly 进行交互式可视化
• RESTful API 接口

前提条件

• Python 3.8+
• Alpha Vantage API 密钥（用于获取更多数据）

安装

1. 克隆仓库：

git clone <repository-url>
cd fin-mcp

2. 创建一个虚拟环境并激活它：

python -m venv venv
source venv/bin/activate  # 在 Windows 上：venv\Scripts\activate

3. 安装依赖项：

pip install -r requirements.txt

4. 在根目录下创建一个 .env 文件，并添加您的 Alpha Vantage API 密钥：

ALPHA_VANTAGE_API_KEY=your_api_key_here

使用方法

1. 启动服务器：

cd src
python main.py

2. 服务器将在 http://localhost:8000 启动

3. 访问 API 文档，地址为 http://localhost:8000/docs

API 接口

股票数据

• GET /api/v1/stock/{symbol} - 从 yfinance 获取股票数据
• GET /api/v1/alpha-vantage/{symbol} - 从 Alpha Vantage 获取股票数据
• GET /api/v1/search/{query} - 搜索金融信息

可视化

• GET /api/v1/visualize/candlestick/{symbol} - 获取 K 线图
• GET /api/v1/visualize/volume/{symbol} - 获取成交量图
• GET /api/v1/visualize/combined/{symbol} - 获取价格和成交量组合图

使用示例

import requests

# 获取股票数据
response = requests.get("http://localhost:8000/api/v1/stock/AAPL")
data = response.json()

# 获取 K 线图
response = requests.get("http://localhost:8000/api/v1/visualize/candlestick/AAPL")
chart_data = response.json()

许可证

本项目基于 MIT 许可证发布 - 详情请参阅 LICENSE 文件。