AlphaVantage MCP 服务器

这是一个基于 MCP (模型控制协议) 框架的服务器，旨在与 AlphaVantage 金融数据 API 服务集成。有关 AlphaVantage 的更多信息，请访问此处。

项目概述

AlphaVantage 是一个 API 服务，提供实时和历史金融市场数据，包括：

• 股票市场数据
• 外汇数据
• 加密货币数据
• 技术指标
• 基本面数据

本项目将 AlphaVantage 的功能封装成一个 MCP 服务，使其更容易与其他应用程序集成。

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

AlphaVantage 功能

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

1. 股票市场数据

   • 实时报价
   • 历史价格数据
   • 公司信息

2. 技术指标

   • 移动平均线
   • RSI
   • MACD 等

3. 基本面数据

   • 财务报表
   • 盈利报告
   • 公司概况

使用指南

1. 获取 AlphaVantage API 密钥

   • 访问 AlphaVantage 网站
   • 注册并获取 API 密钥

2. 配置 API 密钥

   • 在环境变量中设置 ALPHAVANTAGE_API_KEY
   • 或在配置文件中配置

3. 服务调用

   • 通过 MCP 协议进行调用
   • 有关详细的接口规范，请参阅 API 文档

重要提示

• 请参考 AlphaVantage 的官方文档了解 API 速率限制
• 建议在生产环境中使用高级 API 密钥以获得更高的速率限制
• 安全地处理 API 密钥，切勿在公共代码中暴露它们

贡献

欢迎提交 Issues 和 Pull Requests 来帮助改进项目。

许可证

MIT 许可证

版权所有 (c) 2025 lifejwang11

特此授予任何人免费获得本软件及相关文档文件（“软件”）副本的许可，可以不受限制地处理本软件，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售本软件副本的权利，并允许向其提供本软件的人员这样做，但须符合以下条件：

上述版权声明和本许可声明应包含在本软件的所有副本或主要部分中。

本软件按“原样”提供，不提供任何形式的明示或暗示的保证，包括但不限于适销性、特定用途适用性和不侵权的保证。在任何情况下，作者或版权所有者均不对任何索赔、损害或其他责任负责，无论是在合同、侵权或其他方面，因本软件或本软件的使用或其他交易而产生、产生或与之相关的。