Indian Stock Analysis MCP Server

产品定位

Indian Stock Analysis MCP Server 是一个专门为印度股票市场（NSE/BSE）设计的模型上下文协议（MCP）服务器，用于与MongoDB股票数据交互，提供投资组合推荐和市场洞察。

核心功能

• 印度市场专属：专为NSE和BSE上市股票设计
• 直接MongoDB访问：直接查询MongoDB，无需通过API层
• 知识图谱集成：维护印度股票的持久分析数据
• Alpha Vantage限速处理：自动处理免费层API限制
• 模块化架构：清晰的代码结构，关注点分离
• 环境配置：使用.env进行简单配置
• LLM优化数据：自动限制和简化数据响应，便于Claude处理
• 分段投资组合分析：将大型投资组合分成小段处理，防止超时

适用场景

• 印度股票投资组合分析
• 股票推荐和移除建议
• 市场趋势分析
• 技术指标分析
• API管理

工具列表

投资组合分析

• 获取投资组合持仓：检索当前印度股票投资组合的基本信息
• 获取投资组合摘要：获取投资组合的高级概述
• 分析投资组合：分析投资组合持仓，提供指标和推荐

股票推荐

• 获取股票推荐：根据财务指标获取印度股票推荐
• 获取移除推荐：识别应从投资组合中移除的印度股票

市场趋势

• 获取市场趋势推荐：根据当前市场趋势找到必买的印度股票

知识图谱

• 查询知识图谱：查询印度股票知识图谱的历史分析和洞察

市场数据

• 获取Alpha Vantage数据：访问Alpha Vantage API数据，用于印度股票市场
• 搜索股票代码：按名称或关键词搜索印度股票代码

技术分析

• 获取技术分析：获取印度股票的技术分析指标（SMA、RSI）
• 获取优化技术分析：智能技术分析，避免限速

API管理

• 获取Alpha Vantage API状态：检查当前API调用和限速状态

常见问题解答

MCP工具未出现

如果工具未在Claude中出现，请检查：

1. 日志：查看日志文件
2. 服务器命名：确保服务器键名使用连字符
3. 新对话：在Claude中开始新对话
4. 开发者模式：在Claude设置中启用开发者模式
5. 路径：确保所有路径都是绝对路径
6. Python路径：使用完整的Python可执行文件路径

常见问题

1. Python未找到：确保配置中的Python路径正确
2. MongoDB连接问题：检查MongoDB是否在配置的URI上运行
3. 工具架构问题：确保所有工具都有正确的架构定义
4. Claude桌面版本：保持Claude桌面更新到最新版本
5. 服务器名称不匹配：代码中的服务器名称必须与配置文件匹配
6. 大数据响应：使用分段分析处理大型数据集

使用教程

使用依赖

• Python 3.9+
• MongoDB运行在localhost:27017，数据库名为"stock_data"
• Alpha Vantage API密钥（免费层支持）
• Claude桌面应用

安装教程

1. 克隆仓库： bash git clone <repository-url> cd stock-mcp-server

2. 安装依赖： bash pip install -r requirements.txt

3. 创建.env文件： bash cp .env.example .env

4. 编辑.env文件配置设置

调试方式

启动MCP服务器：

python server.py

配置Claude桌面应用： 1. 创建或编辑配置文件 2. 添加股票分析MCP服务器配置 3. 启动或重启Claude桌面 4. 验证服务器连接

示例提示

• "你能提供我的投资组合摘要吗？"
• "分析我的投资组合的第1段"
• "分析我的投资组合的第2段，segment_size=8"
• "分析我的投资组合的第3段，包含详细指标"
• "我的投资组合第2段中有哪些股票？"
• "我的投资组合中哪些行业占比最多？"
• "你能提供关于我的印度股票投资组合的推荐吗？"
• "分析我的投资组合中的银行股"
• "本季度印度市场我应该注意哪些市场趋势？"
• "我的投资组合中哪些股票应该考虑卖出？"
• "哪些新的NSE股票会补充我的当前投资组合？"
• "找到本周BSE表现最好的股票"
• "你能找到关于Reliance Industries股票的信息吗？"
• "TCS股票的技术指标是什么？"
• "在印度市场中搜索与HDFC相关的股票"

许可证

该项目遵循 MIT 开源许可条款。