🚀 MCP 股票市场
MCP 股票市场是一款借助 Alpha Vantage API 获取股票市场数据的模型上下文协议 (MCP) 工具。它能让用户通过简洁的 MCP 接口，轻松访问任意股票代码的每日股票市场数据。
🚀 快速开始
需求
- Node.js v18 或更高版本
- 一个 Alpha Vantage API 密钥（免费层可用）
安装
- 安装依赖项
npm install
- 基于
.env.example创建一个.env文件，并添加您的 Alpha Vantage API 密钥
ALPHA_VANTAGE_API_KEY=your_api_key_here
您可以从 Alpha Vantage 免费获取一个 API 密钥。
- 构建项目
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 次调用
- 每分钟 5 次调用
如果您需要更多容量，请考虑升级到他们的付费计划。
故障排除
如果遇到问题：
- 确保您的 Alpha Vantage API 密钥正确设置在
.env文件中 - 检查是否使用了 Node.js 版本 18 或更高版本
- 验证 MCP 客户端配置中的路径是否正确
- 重新启动您的 MCP 客户端