AlphaVantage MCP Server

AlphaVantage MCP 服务

这是一个基于 MCP（Model Control Protocol）框架的服务，旨在与 AlphaVantage 金融数据 API 服务集成。有关 AlphaVantage 的更多信息，请参阅此处

项目概述

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

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

本项目将 AlphaVantage 的功能封装为 MCP 服务，便于与其他应用集成。

MCP 服务安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 AlphaVantage MCP Server：

npx -y @smithery/cli install @lifejwang11/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
# or
.\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 密钥，切勿将其暴露在公开代码中

贡献

欢迎提交 Issue 和 Pull Request，帮助改进项目。

许可证

MIT License

版权所有 (c) 2025 lifejwang11

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

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

本软件按“原样”提供，不附带任何明示或暗示的保证，包括但不限于适销性、特定用途适用性和非侵权性的保证。在任何情况下，作者或版权持有人均不对因本软件或本软件的使用或其他处置而产生的任何索赔、损害或其他责任负责，无论是合同诉讼、侵权行为还是其他诉讼。