Stock MCP Server

🚀 印度股票分析中间件（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的方式：

1. 首先检查API状态：

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

2. 使用优化工具：

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

3. 批量相似请求：

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

4. 使用缓存提高效率：

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

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