MCP 股票市场

一个使用 Alpha Vantage API 获取股票市场数据的模型上下文协议 (MCP) 工具。该工具通过一个简单的 MCP 接口，提供对任何股票代码的每日股票市场数据的访问。

要求

• Node.js v18 或更高版本
• 一个 Alpha Vantage API 密钥 (提供免费层级)

设置

1. 安装依赖

   npm install
   

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

   ALPHA_VANTAGE_API_KEY=your_api_key_here
   

   你可以从 Alpha Vantage 获取免费的 API 密钥。

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 替换为包含此仓库的父目录的实际绝对路径。

可用工具

get-stock-data

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

参数：

• symbol: 股票代码 (例如，IBM, AAPL, MSFT, GOOG, AMZN)

在 MCP 客户端中的使用示例：

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

示例响应：

股票: AAPL
最后更新: 2025-03-12
时区: US/Eastern

每日价格:

日期: 2025-03-12
开盘价: $178.35
最高价: $180.13
最低价: $177.53
收盘价: $179.63
成交量: 58,492,206
---

日期: 2025-03-11
开盘价: $177.99
最高价: $179.70
最低价: $176.86
收盘价: $178.95
成交量: 62,630,570
---

开发

项目结构

• src/index.ts - 包含 MCP 服务器和工具实现的主应用程序文件
• build/ - 编译后的 JavaScript 输出
• .env - 环境变量 (API 密钥)

命令

• npm run build - 构建 TypeScript 代码

API 使用注意事项

此工具使用 Alpha Vantage API 来检索股票市场数据。 Alpha Vantage 的免费层级有以下限制：

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

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

故障排除

如果遇到问题：

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