MCP Server for Alpha Vantage API (@missionsquad/avantage)

基本能力

产品定位

mcp-avantage 是一个金融数据服务工具，专注于为语言学习模型（LLMs）提供金融数据的访问和分析能力。

核心功能

• 金融数据覆盖：支持股票数据、基本面数据、外汇数据、加密货币数据、商品数据、经济指标、技术指标、Alpha 智能数据（新闻、情绪等）和期权数据（高级版）。
• 多用户支持：通过 extraArgs 安全处理 Alpha Vantage API 密钥，或回退到环境变量。
• 资源管理：使用 ResourceManager 高效管理 AVantage 客户端实例。
• 强类型支持：基于 TypeScript 构建，利用 @missionsquad/avantage 的类型和 Zod 模式进行工具参数定义。
• 标准 MCP 接口：使用 @missionsquad/fastmcp 进行 MCP 通信。

适用场景

• 金融分析：实时获取股票、外汇、加密货币等金融数据进行分析。
• 新闻和情绪分析：通过 Alpha 智能数据获取新闻和情绪分析。
• 经济指标监控：跟踪经济指标以支持决策。
• 期权交易：高级用户可以使用期权数据进行交易分析。

工具列表

• alphaIntelligence_*：Alpha 智能数据工具。
• commodities_*：商品数据工具。
• coreStock_*：核心股票数据工具。
• crypto_*：加密货币数据工具。
• economicIndicators_*：经济指标工具。
• forex_*：外汇数据工具。
• fundamentalData_*：基本面数据工具。
• optionsData_*：期权数据工具（高级版）。
• technicalIndicators_*：技术指标工具。

常见问题解答

• 如何获取 API 密钥？：可以从 Alpha Vantage 获取。
• 如何支持多用户？：通过 extraArgs.apiKey 传递用户特定的 API 密钥。
• 如何启用高级功能？：在 .env 文件中设置 AV_PREMIUM=true。

使用教程

使用依赖

• Node.js v20 或更高版本
• npm 或 yarn
• Alpha Vantage API 密钥

安装教程

1. 克隆或复制： bash git clone <repository-url> mcp-avantage-server cd mcp-avantage-server
2. 安装依赖： bash npm install # 或 yarn install
3. 配置环境：
4. 复制 .env.example 到 .env。
5. 编辑 .env 并设置 API_KEY 为你的 Alpha Vantage API 密钥。
6. 可选设置 AV_PREMIUM=true 以启用高级功能。
7. 根据需要调整 LOG_LEVEL 或 RESOURCE_CLEANUP_INTERVAL。
8. 构建项目： bash npm run build # 或 yarn build
9. 启动服务器： bash npm start # 或 yarn start 服务器将在 stdio 上监听 MCP 请求。

调试方式

• 查看日志：根据 LOG_LEVEL 设置查看不同级别的日志信息。
• 检查 API 密钥：确保 extraArgs.apiKey 或 .env 中的 API_KEY 正确设置。
• 验证工具调用：使用 list_tools 命令获取可用工具列表及其参数模式。

许可证

该项目遵循 MIT 开源许可条款。