Financial Analysis MCP Server

基本能力

产品定位

fin-mcp 是一个专注于金融分析的服务器，提供股票数据检索、金融信息搜索和交互式可视化功能。

核心功能

• 从 yfinance 检索股票数据
• 集成 Alpha Vantage API
• 金融信息的网络搜索
• 使用 Plotly 进行交互式可视化
• 提供 RESTful API 端点

适用场景

• 金融数据分析
• 投资研究
• 市场监控
• 股票交易策略开发

工具列表

• yfinance: 用于股票数据检索
• Alpha Vantage API: 提供额外的金融数据
• Plotly: 用于交互式数据可视化

常见问题解答

• 需要 Alpha Vantage API 密钥以获取额外数据
• 确保 Python 3.8+ 环境

使用教程

使用依赖

• Python 3.8+
• Alpha Vantage API 密钥

安装教程

1. 克隆仓库:

git clone <repository-url>
cd fin-mcp

1. 创建并激活虚拟环境:

python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

1. 安装依赖:

pip install -r requirements.txt

1. 创建 .env 文件并添加 Alpha Vantage API 密钥:

ALPHA_VANTAGE_API_KEY=your_api_key_here

调试方式

1. 启动服务器:

cd src
python main.py

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

2. 访问 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} - 获取蜡烛图
• 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()

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

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。