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，并确保在免费层限制内高效地进行股票数据分析。