🚀 印度股票分析中间件（MCP）服务器文档
印度股票分析中间件（MCP）服务器是一款专门用于处理和分析印度股票市场数据的工具。它具备从MongoDB数据库获取股票数据的能力，同时可借助Alpha Vantage API获取实时市场数据，为股票分析工作提供了有力支持。
🚀 快速开始
印度股票分析中间件（MCP）服务器能有效处理和分析印度股票市场数据，通过与MongoDB和Alpha Vantage API的结合，为用户提供丰富的股票数据及分析功能。
✨ 主要特性
- 数据存储：可从MongoDB中读取和写入股票数据，方便数据的管理和存储。
- 实时数据获取：利用Alpha Vantage API获取实时股票价格、技术指标等数据，确保数据的及时性。
- 数据分析：提供多种分析工具，如技术指标计算、市场趋势分析等，助力用户深入了解股票市场。
- API管理：内置对Alpha Vantage免费层API的管理和优化，保障在免费层限制内高效使用API。
📦 安装指南
环境变量
需在项目的.env文件中定义以下环境变量：
MongoDB配置
MONGODB_URI：MongoDB连接字符串（默认值：mongodb://localhost:27017）MONGODB_DB_NAME：数据库名称（默认值：stock_data）MONGODB_HOLDINGS_COLLECTION：持股集合名称（默认值：holdings）MONGODB_FINANCIALS_COLLECTION：财务数据集合名称（默认值：detailed_financials）MONGODB_KNOWLEDGE_GRAPH_COLLECTION：知识图谱集合名称（默认值：stock_knowledge_graph）
Alpha Vantage API配置
ALPHA_VANTAGE_API_KEY：你的Alpha Vantage API密钥ALPHA_VANTAGE_BASE_URL：Alpha Vantage API URL（默认值：https://www.alphavantage.co/query）ALPHA_VANTAGE_RATE_LIMIT_MINUTE：每分钟允许的API调用次数（默认值：5）ALPHA_VANTAGE_RATE_LIMIT_DAY：每天允许的API调用次数（默认值：500）ALPHA_VANTAGE_DEFAULT_EXCHANGE：默认交易所（用于印度股票，默认值：NSE）
MCP服务器配置
MCP_SERVER_NAME：服务器名称（默认值：stock-analysis-mcp）MCP_SERVER_VERSION：服务器版本（默认值：0.1.0）
日志配置
LOG_LEVEL：日志级别（默认值：INFO）LOG_FORMAT：日志消息格式
缓存设置
CACHE_ENABLED：启用缓存（默认值：True）CACHE_TTL：缓存过期时间，以秒为单位（默认值：3600）
📚 详细文档
Alpha Vantage免费层支持
该服务器针对Alpha Vantage的免费层API进行了优化，具体限制和支持的端点如下：
- 每分钟5次API调用限制
- 每天500次API调用限制
- 支持以下基本端点：
GLOBAL_QUOTE：当前价格信息TIME_SERIES_DAILY：日度价格历史数据OVERVIEW：公司信息SYMBOL_SEARCH：查找印度股票符号- 基本技术指标（SMA、RSI）
API管理
该服务器集成了对Alpha Vantage API的复杂管理，以在免费层限制内有效运行：
速率限制跟踪
- 维护每个分钟窗口内的全局API调用计数器。
- 自动检测和处理来自Alpha Vantage的速率限制响应。
- 提供通过
get_alpha_vantage_status工具获取API状态信息。
智能调用管理
- 预检检查：在进行API调用之前，工具会检查是否会超出速率限制。
- 成本意识处理：每个API函数都有一个分配的“成本”来跟踪其影响。
- 优雅降级：当达到速率限制时，工具提供静态数据或教育内容。
- 目标调用：技术分析可以配置为仅检索特定指标。
回退机制
当达到速率限制时，系统会提供替代内容：
- 静态市场数据用于trending股票。
- 教育性内容关于技术指标。
- 可用的历史数据。
- 关于何时再次尝试的明确消息。
💻 使用示例
基础用法
以下是Claude高效使用API的方式：
- 首先检查API状态：
- "让我先检查Alpha Vantage API的状态再继续"
- 这有助于规划在5次调用限制内可以进行哪些调用
- 使用优化工具：
- "我会使用优化的技术分析来获取仅SMA指标"
- 这样可以只为请求的信息做出必要的API调用
- 批量相似请求：
- "让我先收集所有股票符号，然后一起查询它们"
- 这样可以减少不必要的API调用次数
- 使用缓存提高效率：
- 利用缓存功能，避免重复获取相同数据
- 设置合适的
CACHE_TTL以保持数据新鲜度
通过以上方法，可以最大化利用Alpha Vantage API，并确保在免费层限制内高效地进行股票数据分析。