Alpha Vantage MCP Server

Alpha Vantage MCP 服务

一个模型上下文协议（MCP）服务，将 Alpha Vantage 的各类 API 端点公开为 MCP 工具，提供核心股票、期权、智能分析、基本面数据和技术指标等金融数据的访问能力。此服务简化了将 Alpha Vantage 数据集成到兼容 MCP 的 Agent 和系统中的过程。

前提条件

• Node.js（建议使用 v18 或更高版本）
• npm（随 Node.js 一起提供）
• Alpha Vantage API 密钥
• （可选）兼容 MCP 的客户端或运行器（例如 VSCode 扩展、CLI）

设置

1. 克隆仓库，或确保当前位于项目目录中。

2. 安装依赖项：

   npm install
   

3. 配置：

   • 从 https://www.alphavantage.co/ 获取 Alpha Vantage API 密钥。
   • 在 MCP 运行器的设置中配置 ALPHAVANTAGE_API_KEY 环境变量。建议使用此方法，以便与 MCP 客户端无缝集成。通过 MCP 运行器运行时，请避免使用 .env 文件。

构建和运行

1. 构建服务：

   npm run build
   

   这将创建一个 build 目录，其中包含编译后的 JavaScript 代码。

2. 运行服务：

   npm run start
   

   或直接运行：

   node build/index.js
   

3. 通过 MCP 运行器运行： 将 MCP 客户端配置为使用 stdio 传输运行此服务。 MCP 设置项示例（请将 /path/to/mcp-alphavantage 替换为实际路径，并将 YOUR_API_KEY_HERE 替换为实际密钥）：

   "alphavantage": {
     "transportType": "stdio",
     "command": "node",
     "args": [
       "/path/to/mcp-alphavantage/build/index.js"
     ],
     "env": {
       "ALPHAVANTAGE_API_KEY": "YOUR_API_KEY_HERE"
     }
     // ... other optional settings ...
   }
   

可用工具

此服务将 Alpha Vantage API 端点作为独立的 MCP 工具公开，并按功能分类：

• 核心股票
• 期权数据
• Alpha 智能分析
• 基本面数据
• 技术指标
• 外汇
• 加密货币
• 大宗商品
• 经济指标

连接到此服务的 MCP Agent 可通过自省自动发现每种工具的详细输入架构和说明。

项目结构

项目采用模块化结构：

.
├── src/
│   ├── index.ts          # Server entry point
│   └── tools/
│       ├── index.ts      # Registers all tool categories
│       ├── fundamentals/ # Fundamental Data tools
│       │   └── ...
│       ├── indicators/   # Technical Indicators tools
│       │   └── ...
│       ├── intelligence/ # Alpha Intelligence tools
│       │   └── ...
│       ├── options/      # Options Data tools
│       │   └── ...
│       ├── stocks/       # Core Stocks tools
│       │   └── ...
│       ├── forex/        # Forex tools
│       │   └── ...
│       ├── crypto/       # Cryptocurrency tools
│       │   └── ...
│       ├── commodities/  # Commodities tools
│       │   └── ...
│       └── economic/     # Economic Indicators tools
│           └── ...
├── memory-bank/          # Project documentation
│   └── ...
├── package.json          # Project dependencies and scripts
├── tsconfig.json         # TypeScript configuration
├── eslint.config.js      # ESLint configuration
├── .prettierrc           # Prettier configuration
├── LICENSE               # Project license
└── README.md             # This file

缓存

此服务为工具响应实现了内存中的最近最少使用（LRU）缓存。这有助于减少对 Alpha Vantage API 的重复调用，从而提高性能并遵守速率限制。

• 机制： 缓存根据工具名称和输入参数存储响应。
• 可配置的 TTL： 每种工具的缓存数据都具有可配置的生存时间（TTL），定义于 src/cacheConfig.ts 中。这样可以根据各个 Alpha Vantage 端点所提供数据的更新频率，设置不同的缓存时长。

许可

本项目依据自由软件基金会发布的 GNU 通用公共许可证授权，您可以选择使用第 3 版或（由您选择）任何更高版本。详情请参见 LICENSE 文件。

贡献

欢迎贡献！请遵循标准的 Fork 和 Pull Request 工作流。

支持

如有问题或疑问，请在 GitHub 仓库中提交 issue。