Indonesian Stock Analysis MCP Server

Indonesian Stock Analysis MCP Server

An MCP (Model Context Protocol) server that provides Indonesian stock (IDX) analysis tools for Claude Code. Ask Claude Code questions about stocks and get real-time analysis with buy/sell recommendations.

Features

• Real-time Stock Data: Current prices, historical data for all IDX stocks
• Technical Analysis: RSI, MACD, Moving Averages, Bollinger Bands
• Fundamental Analysis: P/E, P/B, ROE, EPS, Dividend Yield, and more
• Market Movers: Track top gainers and losers from IDX30
• Smart Logging: All recommendations saved to logs/ for tracking
• Seamless Integration: Works directly in Claude Code - just ask questions!

Quick Start

1. Install Dependencies

cd /Users/antariksa/Project/stock_ai_agent
pip install -r requirements.txt

2. Configure Claude Code

Add to your MCP settings file (~/.config/claude-code/mcp_settings.json or Claude Desktop config):

{
  "mcpServers": {
    "idx-stock-analysis": {
      "command": "python",
      "args": ["-m", "src.mcp_server"],
      "cwd": "/Users/antariksa/Project/stock_ai_agent"
    }
  }
}

Important: Update the cwd path to match your actual project location!

3. Restart Claude Code

Restart Claude Code to load the MCP server.

4. Start Analyzing!

Ask Claude Code questions like:

• "What's the current price of BBCA?"
• "Analyze BBRI technical indicators"
• "Should I buy TLKM right now?"
• "Show me today's top market movers"
• "Compare BBCA and BMRI fundamentals"

MCP Tools Available

The server provides 7 tools that Claude Code can use:

1. get_stock_price - Current price and basic info
2. get_historical_data - Historical OHLCV data
3. get_technical_indicators - RSI, MACD, MA, Bollinger Bands
4. get_fundamentals - P/E, P/B, ROE, margins, etc.
5. get_market_movers - Top gainers/losers from IDX30
6. log_recommendation - Save buy/sell decisions
7. get_recommendation_history - Review past recommendations

Market Hours

Indonesian Stock Exchange (IDX) - Western Indonesia Time (WIB):

• Pre-open: 08:45-09:00
• Session 1: 09:00-12:00
• Break: 12:00-13:30
• Session 2: 13:30-16:00

Best used during trading hours for real-time decisions.

Documentation

• QUICKSTART.md - Get started in 5 minutes! ⚡
• SETUP.md - Detailed installation and troubleshooting
• EXAMPLES.md - Example conversations and use cases
• requirements.txt - Python dependencies

Project Structure

stock_ai_agent/
├── src/
│   └── mcp_server.py          # Main MCP server with 7 stock analysis tools
├── logs/                       # Auto-generated recommendation logs
│   └── recommendations_*.jsonl
├── QUICKSTART.md               # 5-minute setup guide
├── SETUP.md                    # Detailed setup instructions
├── EXAMPLES.md                 # Usage examples and sample queries
├── requirements.txt            # Python dependencies
├── pyproject.toml              # Project configuration
├── test_server.py              # Test suite
└── setup_env.sh                # Automated environment setup

How It Works

1. MCP Server (src/mcp_server.py): Exposes 7 tools via Model Context Protocol
2. Claude Code: Automatically calls these tools when you ask stock questions
3. Data Source: Yahoo Finance (yfinance) - free, real-time Indonesian stock data
4. Analysis: Technical indicators (ta library) + fundamental data
5. Logging: All recommendations saved to logs/ directory

Popular Indonesian Stocks

| Sector | Stocks | |--------|--------| | Banking | BBCA, BBRI, BMRI, BBNI | | Telecom | TLKM, EXCL | | Consumer | UNVR, INDF, ICBP | | Auto | ASII, UNTR | | Mining | ADRO, PTBA, ANTM | | Cement | SMGR, INTP |

Contributing

Found a bug or want to add features?

1. Fork the repository
2. Make your changes
3. Submit a pull request

Ideas for enhancements:

• Add more Indonesian stock data sources (Stockbit API, IDX API)
• Implement portfolio tracking and P&L calculation
• Add news sentiment analysis
• Create automated hourly alerts during market hours
• Backtesting framework for recommendations

License

MIT License

stock_mcp