AI导哈

股票数据获取工具

一个通过Alpha Vantage API获取股票市场数据的MCP工具，提供简单接口查询任意股票代码的每日市场数据。

  • by ctoouli
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 ctoouli/mcp-stock-market

使用说明

MCP股票市场

一种模型上下文协议（MCP）工具，用于使用AlphaVantage API检索股票市场数据。该工具通过简单的MCP接口提供对任何股票品种的每日股票市场数据的访问。

需求

  • Node.js v18或更高版本
  • AlphaVantage API密钥（提供免费等级）

设置

  1. 安装依赖项

    npm install

  2. 创建一个 .env 文件基于 .env.example 并添加您的Alpha Vantage API密钥

    ALPHA_VANTAGE_API_KEY=your_api_key_here

    您可以从获得免费的API密钥 阿尔法Vantage.

  3. 构建项目

    npm run build

MCP客户端配置

要将此工具用于MCP客户端，您需要更新MCP服务器配置。将以下内容添加到客户端的配置中：

{
  "mcpServers": {
    "stock-market": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-stock-market/build/index.js"
      ]
    }
  }
}

确保更换 /ABSOLUTE/PATH/TO/PARENT/FOLDER 其中包含指向包含此存储库的父目录的实际绝对路径。

可用工具

获取股票数据

检索特定股票代码的每日股市数据。

参数：

  • symbol：股票代码（例如，IBM、AAPL、MSFT、GOOG、AMZN）

MCP客户端中的示例用法：

@stock-market get-stock-data symbol=AAPL

示例响应：

Stock: AAPL
Last Updated: 2025-03-12
Time Zone: US/Eastern

Daily Prices:

Date: 2025-03-12
Open: $178.35
High: $180.13
Low: $177.53
Close: $179.63
Volume: 58,492,206
---

Date: 2025-03-11
Open: $177.99
High: $179.70
Low: $176.86
Close: $178.95
Volume: 62,630,570
---

发展

项目结构

  • src/index.ts -MCP服务器主应用文件及工具实现
  • build/ -编译的JavaScript输出
  • .env -环境变量（API键）

命令

  • npm run build -构建TypeScript代码

API使用说明

该工具使用AlphaVantage API检索股票市场数据。Alpha Vantage的免费版有以下限制：

  • 每天25个API调用
  • 每分钟5次API调用

如果您需要更多容量，请考虑升级到他们的高级计划。

故障排除

如果您遇到问题：

  1. 确保您的Alpha Vantage API密钥在 .env 文件
  2. 检查您是否使用Node.js版本18或更高版本
  3. 验证MCP客户端配置中的路径是否正确
  4. 重新启动MCP客户端

相关 MCP