AI导哈

金融数据服务

一个通过Alpha Vantage API提供实时金融市场数据访问的Model Context Protocol (MCP)服务器，支持股票报价、公司信息、加密货币汇率和期权数据查询。

  • by QuantMLResearch
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 QuantML-Github/alpha-vantage-mcp

使用说明

Alpha Vantage MCP服务器

一种模型上下文协议（MCP）服务器，通过免费的 阿尔法Vantage API该服务器实现了用于检索股票报价和公司信息的标准化接口。

特性

  • 实时股票报价，包括价格、交易量和变动数据
  • 详细的公司信息，包括行业、行业和市值
  • 实时加密货币汇率与买入/卖出价格
  • 具有高级过滤和排序功能的历史选项链数据
  • 内置错误处理和速率限制管理

安装

使用克劳德桌面

通过Docker安装

  • 克隆存储库并构建本地映像，供您的Claude桌面客户端使用
cd alpha-vantage-mcp
docker build -t mcp/alpha-vantage .
  • 改变你的 claude_desktop_config.json 要匹配以下内容，请替换 REPLACE_API_KEY 使用您的实际密钥：

claude_desktop_config.json 路径

  • 在MacOS上： ~/Library/Application\ Support/Claude/claude_desktop_config.json
  • 在Windows上： %APPDATA%/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "alphavantage": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "ALPHA_VANTAGE_API_KEY",
        "mcp/alpha-vantage"
      ],
      "env": {
        "ALPHA_VANTAGE_API_KEY": "REPLACE_API_KEY"
      }
    }
  }
}

通过Smithery安装

通过以下方式自动安装Alpha Vantage MCP Server for Claude Desktop 史密瑟里:

npx -y @smithery/cli install @berlinbra/alpha-vantage-mcp --client claude

Development/Unpublished Servers Configuration 

{
 "mcpServers": {
  "alpha-vantage-mcp": {
   "args": [
    "--directory",
    "/Users/{INSERT_USER}/YOUR/PATH/TO/alpha-vantage-mcp",
    "run",
    "alpha-vantage-mcp"
   ],
   "command": "uv",
   "env": {
    "ALPHA_VANTAGE_API_KEY": "<insert api key>"
   }
  }
 }
}

安装程序包

uv install -e .

跑步

通过json文件将Claude客户端与MCP工具连接并安装包后，Claude应该看到服务器的MCP工具：

您可以通过以下方式自行运行服务器： 在alpha优势mcp仓库中：

uv run src/alpha_vantage_mcp/server.py

与检查员

* npx @modelcontextprotocol/inspector uv --directory /Users/{INSERT_USER}/YOUR/PATH/TO/alpha-vantage-mcp run src/alpha_vantage_mcp/server.py `

可用工具

服务器实现了五个工具：

  • get-stock-quote：获取特定公司的最新股票报价
  • get-company-info：获取特定公司的股票相关信息
  • get-crypto-exchange-rate：获取当前加密货币汇率
  • get-time-series：获取股票的历史每日价格数据
  • get-historical-options：获取具有排序功能的历史选项链数据

获取股票报价

输入架构：

{
    "symbol": {
        "type": "string",
        "description": "Stock symbol (e.g., AAPL, MSFT)"
    }
}

示例响应：

Stock quote for AAPL:

Price: $198.50
Change: $2.50 (+1.25%)
Volume: 58942301
High: $199.62
Low: $197.20

获取公司信息

检索给定符号的详细公司信息。

输入架构：

{
    "symbol": {
        "type": "string",
        "description": "Stock symbol (e.g., AAPL, MSFT)"
    }
}

示例响应：

Company information for AAPL:

Name: Apple Inc
Sector: Technology
Industry: Consumer Electronics
Market Cap: $3000000000000
Description: Apple Inc. designs, manufactures, and markets smartphones...
Exchange: NASDAQ
Currency: USD

获取加密货币汇率

使用其他市场数据检索实时加密货币汇率。

输入架构：

{
    "crypto_symbol": {
        "type": "string",
        "description": "Cryptocurrency symbol (e.g., BTC, ETH)"
    },
    "market": {
        "type": "string",
        "description": "Market currency (e.g., USD, EUR)",
        "default": "USD"
    }
}

示例响应：

Cryptocurrency exchange rate for BTC/USD:

From: Bitcoin (BTC)
To: United States Dollar (USD)
Exchange Rate: 43521.45000
Last Updated: 2024-12-17 19:45:00 UTC
Bid Price: 43521.00000
Ask Price: 43522.00000

获取时间序列

检索每日时间序列（OHLCV）数据。

输入架构：

{
    "symbol": {
        "type": "string",
        "description": "Stock symbol (e.g., AAPL, MSFT)"
    },
    "outputsize": {
        "type": "string",
        "description": "compact (latest 100 data points) or full (up to 20 years of data)",
        "default": "compact"
    }
}

示例响应：

Time Series Data for AAPL (Last Refreshed: 2024-12-17 16:00:00):

Date: 2024-12-16
Open: $195.09
High: $197.68
Low: $194.83
Close: $197.57
Volume: 55,751,011

获取历史选项

使用高级排序和过滤功能检索历史选项链数据。

输入架构：

{
    "symbol": {
        "type": "string",
        "description": "Stock symbol (e.g., AAPL, MSFT)"
    },
    "date": {
        "type": "string",
        "description": "Optional: Trading date in YYYY-MM-DD format (defaults to previous trading day, must be after 2008-01-01)",
        "pattern": "^20[0-9]{2}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])$"
    },
    "limit": {
        "type": "integer",
        "description": "Optional: Number of contracts to return (default: 10, use -1 for all contracts)",
        "default": 10,
        "minimum": -1
    },
    "sort_by": {
        "type": "string",
        "description": "Optional: Field to sort by",
        "enum": ["strike", "expiration", "volume", "open_interest", "implied_volatility", "delta", "gamma", "theta", "vega", "rho", "last", "bid", "ask"],
        "default": "strike"
    },
    "sort_order": {
        "type": "string",
        "description": "Optional: Sort order",
        "enum": ["asc", "desc"],
        "default": "asc"
    }
}

示例响应：

Historical Options Data for AAPL (2024-02-20):

Contract 1:
Strike: $190.00
Expiration: 2024-03-15
Last: $8.45
Bid: $8.40
Ask: $8.50
Volume: 1245
Open Interest: 4567
Implied Volatility: 0.25
Greeks:
  Delta: 0.65
  Gamma: 0.04
  Theta: -0.15
  Vega: 0.30
  Rho: 0.25

Contract 2:
...

错误处理

该服务器包括针对各种场景的全面错误处理：

  • 请求频率超限
  • API密钥无效
  • 网络连接问题
  • 超时处理
  • 响应格式错误

错误消息以清晰易读的格式返回。

先决条件

  • Python 3.12或更高版本
  • httpx
  • 主控程序

贡献者

贡献

欢迎投稿！请随时提交拉取请求。

许可证

此MCP服务器根据MIT许可证获得许可。 这意味着您可以根据MIT许可证的条款和条件自由使用、修改和分发软件。有关更多详细信息，请参阅项目存储库中的LICENSE文件。

相关 MCP