MCP-100_stock-market-server

🚀 股票市场 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
# 这里只是示意调用，实际可能需要封装调用逻辑
# 调用 get_ticker_price 函数获取 AAPL 的实时价格

高级用法

以下是获取公司财务报表的示例，以获取苹果公司（AAPL）的收入报表为例：

# 调用 get_financial_statement 函数获取 AAPL 的收入报表

🔧 技术细节

技术栈

• TypeScript
• Node.js
• Alpha Vantage API
• MCP SDK (@modelcontextprotocol/sdk)

调试

由于 MCP 服务器通过标准输入输出(stdio)通信，调试可能比较困难。推荐使用 MCP Inspector 工具进行调试：

npm run inspector

运行后，Inspector 将提供一个浏览器访问地址，可以通过浏览器使用调试工具。

📄 许可证

[添加许可证信息]

⚠️ 重要提示

使用前需要确保有有效的 Alpha Vantage API 密钥，并且请注意 Alpha Vantage API 的调用频率限制。所有 API 响应都以 JSON 格式返回。