Alphavantage MCP

🚀 AlphaVantage MCP 服务器

本项目是一个基于MCP（模型控制协议）框架的服务器，旨在无缝集成AlphaVantage金融数据API服务。借助该服务器，开发者能够更便捷地获取各类金融数据。更多关于AlphaVantage的信息可查看此处。

🚀 快速开始

项目概述

AlphaVantage是一个强大的API服务，可提供实时和历史金融市场数据，涵盖股票市场数据、外汇数据、加密货币数据、技术指标以及基本面数据等。本项目将AlphaVantage的功能封装到一个MCP服务中，极大地简化了其与其他应用程序的集成过程。

安装指南

先决条件

• Python 3.12
• pip 包管理器

安装步骤

1. 克隆项目

git clone https://github.com/lifejwang11/alphavantage-mcp
cd alphavantage-mcp

2. 创建并激活虚拟环境（推荐）

python -m venv venv
source venv/bin/activate  # Unix/macOS
# 或者
.\venv\Scripts\activate  # Windows

3. 安装依赖项

pip install -r requirements.txt

4. 配置环境变量

export ALPHAVANTAGE_API_KEY=your_api_key

5. 启动服务器

python main.py

使用指南

1. 获取AlphaVantage API密钥
   • 访问AlphaVantage网站
   • 注册并获取API密钥
2. 配置API密钥
   • 在环境变量中设置ALPHAVANTAGE_API_KEY
   • 或者在配置文件中进行配置
3. 服务调用
   • 通过MCP协议进行调用
   • 参考API文档以获取详细接口规范说明

✨ 主要特性

此MCP服务器支持AlphaVantage的核心功能：

1. 股票市场数据
   • 实时报价
   • 历史价格数据
   • 公司信息
2. 技术指标
   • 移动平均线
   • 相对强度指数（RSI）
   • MACD 等等
3. 基本面数据
   • 财务报表
   • 收益报告
   • 公司概览

⚠️ 注意事项

⚠️ 重要提示

请参考AlphaVantage官方文档了解API速率限制。

💡 使用建议

• 建议在生产环境中使用高级别API密钥以获得更高的速率限制。
• 安全处理API密钥，切勿在公共代码中泄露。

🤝 贡献

欢迎提交问题和拉取请求以帮助改进项目。

📄 许可证

本项目采用MIT License。

版权 (c) 2025 lifejwang11

准许任何人获得本软件及其关联的文档文件（“软件”）副本，可以在不受限制的情况下进行处理，包括但不限于以下权利：使用、复制、修改、合并、发布、分发、授予子许可和/或出售软件副本，并允许向他人提供该软件，前提是以下条件：

本版权声明和本许可声明应包含在所有副本或大量软件部分的副本中。

软件按“原样”提供，不做任何担保，包括但不限于以下担保：对商品性、特定用途适用性以及不侵权的明示或暗示保证。在因合同、侵权或其他行为导致的任何主张、损害或其他责任中，作者或版权持有者概不负责。