Stock Market MCP Server

# Stock Market MCP Server 一个基于 TypeScript 的 MCP 服务器，用于获取股票市场数据。该服务器通过 Alpha Vantage API 提供实时股票市场信息和公司财务数据。 ## 生成该 MCPServer 的关键信息 - [.clinerules](https://docs.cline.bot/mcp-servers/mcp-server-from-scratch) - [api-key](https://www.alphavantage.co/support/#api-key) ```md 1.Plan mode help me build a stock market mcp server that uses the AlphaVantage public API I want it to have these tools： - generate US market report/briefing - generate financial statement for company - get ticker price for company - any other basic tools you think would be helpful - api key: <you api key> 2. please test all the tools to confirm their functionality ``` ## 功能特点 ### 工具 - `get_ticker_price` - 获取股票实时价格 - 需要提供股票代码作为参数 - 返回最新的股票价格和时间戳 - `get_market_report` - 获取美国市场报告 - 提供市场整体状况概览 - `get_financial_statement` - 获取公司财务报表 - 支持三种报表类型：收入报表(income)、资产负债表(balance)、现金流量表(cashflow) - 需要提供股票代码和报表类型 - `get_company_overview` - 获取公司概览信息 - 需要提供股票代码 - 返回公司关键指标和基本信息 ## 开发环境配置 ### 安装依赖 ```bash npm install ``` ### 构建项目 ```bash npm run build ``` ### 开发模式（自动重新构建） ```bash npm run watch ``` ## 安装说明 要在 Claude Desktop 中使用此服务器，需要添加服务器配置： ### MacOS 配置文件路径：`~/Library/Application Support/Claude/claude_desktop_config.json` ### Windows 配置文件路径：`%APPDATA%/Claude/claude_desktop_config.json` 配置示例： ```json { "mcpServers": { "stock-market-server": { "command": "/path/to/stock-market-server/build/index.js" } } } ``` ## 调试 由于 MCP 服务器通过标准输入输出(stdio)通信，调试可能比较困难。推荐使用 MCP Inspector 工具进行调试： ```bash npm run inspector ``` 运行后，Inspector 将提供一个浏览器访问地址，可以通过浏览器使用调试工具。 ## 技术栈 - TypeScript - Node.js - Alpha Vantage API - MCP SDK (@modelcontextprotocol/sdk) ## 注意事项 - 使用前需要确保有有效的 Alpha Vantage API 密钥 - 所有 API 响应都以 JSON 格式返回 - 请注意 Alpha Vantage API 的调用频率限制 ## 许可证 [添加许可证信息]