🚀 股票市场 MCP 服务器
这是一个基于 TypeScript 的 MCP 服务器，主要用于获取股票市场数据。它借助 Alpha Vantage API，能够为用户提供实时的股票市场信息以及公司财务数据。
✨ 主要特性
工具
-
get_ticker_price- 获取股票实时价格- 需提供股票代码作为参数。
- 会返回最新的股票价格和时间戳。
-
get_market_report- 获取美国市场报告- 可提供市场整体状况概览。
-
get_financial_statement- 获取公司财务报表- 支持三种报表类型：收入报表(income)、资产负债表(balance)、现金流量表(cashflow)。
- 需提供股票代码和报表类型。
-
get_company_overview- 获取公司概览信息- 需提供股票代码。
- 会返回公司关键指标和基本信息。
📦 安装指南
开发环境配置
安装依赖
npm install
构建项目
npm run build
开发模式（自动重新构建）
npm run watch
在 Claude Desktop 中使用
要在 Claude Desktop 中使用此服务器，需要添加服务器配置：
MacOS
配置文件路径：~/Library/Application Support/Claude/claude_desktop_config.json
Windows
配置文件路径：%APPDATA%/Claude/claude_desktop_config.json
配置示例：
{
"mcpServers": {
"stock-market-server": {
"command": "/path/to/stock-market-server/build/index.js"
}
}
}
💻 使用示例
基础用法
# 以下是调用 get_ticker_price 工具获取股票实时价格的示例
# 假设股票代码为 AAPL
# 代码调用逻辑需根据实际项目封装实现
# 这里仅示意调用该工具的思路
高级用法
# 可以组合多个工具进行复杂的数据获取，例如先获取公司概览信息，再获取财务报表
# 同样，代码调用逻辑需根据实际项目封装实现
🔧 技术细节
技术栈
- TypeScript
- Node.js
- Alpha Vantage API
- MCP SDK (@modelcontextprotocol/sdk)
📄 许可证
[添加许可证信息]
⚠️ 重要提示
- 使用前需要确保有有效的 Alpha Vantage API 密钥。
- 所有 API 响应都以 JSON 格式返回。
- 请注意 Alpha Vantage API 的调用频率限制。
💡 使用建议
由于 MCP 服务器通过标准输入输出(stdio)通信，调试可能比较困难。推荐使用 MCP Inspector 工具进行调试：
npm run inspector
运行后，Inspector 将提供一个浏览器访问地址，可以通过浏览器使用调试工具。