项目简介:

该项目是一个基于 Model Context Protocol (MCP) 实现的服务器，旨在通过标准化的 MCP 工具提供 Alpha Vantage 金融 API 的访问能力。它允许 LLM 客户端或 MCP Agent 调用工具来获取股票行情、历史数据、财务报表、技术指标、经济数据等信息。服务器内置了 LRU 缓存以优化性能和遵守 API 调用限制。

主要功能点:

提供多种 Alpha Vantage API 功能作为 MCP 工具，涵盖股票、期权、智能分析、财务数据、技术指标、外汇、加密货币、大宗商品和经济指标。
通过 MCP 标准注册工具，使其能力可被 LLM 客户端自动发现。
实现内存中的 LRU 缓存，减少重复 API 调用并提升响应速度。
支持 Stdio 等 MCP 标准传输协议。

安装步骤:

确保已安装 Node.js (推荐 v18 或更高版本) 和 npm。
从 GitHub 克隆仓库到本地。
在项目根目录执行 'npm install' 安装依赖。
获取 Alpha Vantage API Key (访问 https://www.alphavantage.co/ 注册)。
在项目根目录执行 'npm run build' 编译 TypeScript 代码。

服务器配置:

该 MCP 服务器需要通过 MCP 客户端/Runner 启动，并通过环境变量 'ALPHAVANTAGE_API_KEY' 提供 API Key。大多数 MCP 客户端提供配置界面来添加服务器。以下是一个示例 MCP 客户端配置片段（请根据实际路径和您的 API Key 进行修改）：

{
  "name": "alphavantage",
  "transportType": "stdio",
  "command": "node",
  "args": [
    "/path/to/your/mcp-alphavantage/build/index.js"
  ],
  "env": {
    "ALPHAVANTAGE_API_KEY": "您的AlphaVantageAPIKey"
  },
  "description": "MCP Server exposing Alpha Vantage financial data and technical indicators."
}

'name': MCP 服务器的标识名称。
'transportType': 使用的传输协议 (此处为 stdio)。
'command': 启动服务器的可执行命令 (此处为 node)。
'args': 传递给命令的参数 (此处为编译后的服务器入口文件路径)。将 '/path/to/your/mcp-alphavantage' 替换为您克隆仓库的实际路径。
'env': 启动服务器时设置的环境变量，用于提供 Alpha Vantage API Key。将 '"您的AlphaVantageAPIKey"' 替换为您实际的 API Key。
'description': 服务器的描述信息。

基本使用方法:

配置完成后，通过您的 MCP 客户端连接到此服务器。连接成功后，客户端将能够自动发现服务器提供的所有 Alpha Vantage 工具及其描述和输入 schema。您或您的 LLM Agent 即可通过调用这些工具来获取实时的股票报价、历史数据、财务信息、技术分析结果以及经济指标等。具体的工具输入参数和返回结构请参考客户端提供的工具描述或 Alpha Vantage 的官方 API 文档。

关键词

信息