印度股票分析中间件（MCP）服务器文档

介绍

印度股票分析中间件（MCP）服务器是一个用于处理和分析印度股票市场数据的工具。它支持从MongoDB数据库获取股票数据，并通过Alpha Vantage API获取实时市场数据。

功能

• 数据存储：从MongoDB中读取和写入股票数据。
• 实时数据获取：使用Alpha Vantage API获取实时股票价格、技术指标等数据。
• 数据分析：提供多种分析工具，如技术指标计算、市场趋势分析等。
• API管理：内置对Alpha Vantage免费层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的方式：

1. 首先检查API状态:

   • "让我先检查Alpha Vantage API的状态再继续"
   • 这有助于规划在5次调用限制内可以进行哪些调用

2. 使用优化工具:

   • "我会使用优化的技术分析来获取仅SMA指标"
   • 这样可以只为请求的信息做出必要的API调用

3. 批量相似请求:

   • "让我先收集所有股票符号，然后一起查询它们"
   • 这样可以减少不必要的API调用次数

4. 使用缓存提高效率:

   • 利用缓存功能，避免重复获取相同数据
   • 设置合适的CACHE_TTL以保持数据新鲜度

通过以上方法，可以最大化利用Alpha Vantage API，并确保在免费层限制内高效地进行股票数据分析。