Indian Stock Analysis MCP Server logo

Indian Stock Analysis MCP Server

by ingpoc

A Model Context Protocol (MCP) server designed for Indian stock market (NSE/BSE) analysis. It interacts with MongoDB stock data and the Alpha Vantage API to provide portfolio recommendations and market insights.

View on GitHub

Last updated: N/A

What is Indian Stock Analysis MCP Server?

This MCP server is designed to provide Indian stock market analysis and portfolio recommendations by integrating with a MongoDB database for stock data, the Alpha Vantage API for market data, and a knowledge graph for persistent analysis. It allows Claude to access portfolio holdings, analyze stock performance, and provide personalized recommendations.

How to use Indian Stock Analysis MCP Server?

To use this server, first install the prerequisites (Python 3.9+, MongoDB, Alpha Vantage API key, Claude Desktop app). Then, clone the repository, install dependencies, configure the .env file, and start the server using python server.py. Finally, configure the Claude Desktop app to connect to the MCP server by editing the claude_desktop_config.json file.

Key features of Indian Stock Analysis MCP Server

  • Exclusive Indian Market Focus (NSE/BSE)

  • Direct MongoDB Access

  • Knowledge Graph Integration

  • Alpha Vantage Rate Limiting

  • Modular Architecture

  • LLM-Optimized Data

  • Segmented Portfolio Analysis

Use cases of Indian Stock Analysis MCP Server

  • Analyze Indian stock portfolio holdings

  • Get personalized stock recommendations

  • Identify market trends in the Indian market

  • Query a knowledge graph for historical stock analysis

FAQ from Indian Stock Analysis MCP Server

How do I handle large portfolios?

Use the segmented analysis approach with the portfolio_analysis tool and adjust the segment and segment_size parameters.

How do I avoid Alpha Vantage API rate limits?

The server includes automatic rate limiting. Use the Get Alpha Vantage API Status tool and optimized tools for technical analysis.

Why are the tools not appearing in Claude?

Check your logs, verify server naming in the configuration file, start a new conversation in Claude, and ensure all paths are absolute and correct.

What if Claude struggles with large data responses?

Use segmented analysis, smaller segment sizes, and the include_details=false option for a quick overview.

How do I run the tests?

Use the ./test_server_startup.sh script for a quick startup test or the python test_mcp_server.py script for a comprehensive test. You can skip Alpha Vantage API calls with the --skip-alpha-vantage flag.