交易服务器

# Clone repository
git clone https://github.com/YOUR_USERNAME/zerodha-trading-mcp.git
cd zerodha-trading-mcp

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Configure environment
cp .env.example .env
# Edit .env with your settings

# Run tests
pytest tests/ -v

# Start MCP server
python src/server.py

zerodha-trading-mcp/
├── src/
│   ├── server.py              # MCP server entry point
│   ├── config.py              # Configuration management
│   ├── mcp/                   # MCP protocol handlers
│   ├── core/                  # Trading engine
│   │   ├── risk_manager.py
│   │   ├── order_manager.py
│   │   └── portfolio_tracker.py
│   ├── adapters/              # Broker adapters
│   │   ├── base.py
│   │   ├── mock_broker.py
│   │   └── kite_adapter.py    # Placeholder for Kite Connect
│   ├── models/                # Data models
│   │   ├── signal.py
│   │   ├── order.py
│   │   ├── position.py
│   │   └── portfolio.py
│   └── utils/                 # Utilities
│       └── logger.py
├── tests/                     # Test suite
│   ├── unit/
│   └── integration/
├── docs/                      # Documentation
│   ├── API.md
│   ├── SETUP.md
│   └── KITE_INTEGRATION.md
├── logs/                      # Log files (gitignored)
├── data/                      # Database (gitignored)
├── .env.example               # Environment template
├── requirements.txt
└── README.md

User: Buy 10 shares of SBIN at market price

Claude: I'll place that order for you.
[Calls place_order tool with symbol=SBIN, action=BUY, quantity=10]

Server Response:
✅ Order Submitted Successfully
- Symbol: SBIN
- Action: BUY
- Quantity: 10
- Status: SUBMITTED
Order ID: abc-123-def

# Environment
ENVIRONMENT=development
DEBUG=true
DRY_RUN=false           # Set to true for testing without real orders

# Broker
BROKER_TYPE=mock        # Change to 'kite' when ready

# Risk Limits
MAX_POSITION_SIZE=500000.0       # ₹5 lakhs per position
MAX_TOTAL_EXPOSURE=2000000.0     # ₹20 lakhs total
MAX_POSITIONS=10                 # Max concurrent positions
MAX_DAILY_LOSS_PCT=5.0          # Circuit breaker at -5%

# Kite Connect (fill when ready)
KITE_API_KEY=your_key_here
KITE_API_SECRET=your_secret_here
KITE_ACCESS_TOKEN=

# Run all tests
pytest tests/ -v

# Run with coverage
pytest tests/ --cov=src --cov-report=html

# Run specific test file
pytest tests/unit/test_trading.py -v

# Run integration tests only
pytest tests/integration/ -v

# 1. Get API credentials
KITE_API_KEY=your_key
KITE_API_SECRET=your_secret

# 2. Update .env
BROKER_TYPE=kite

# 3. Install kiteconnect
pip install kiteconnect

# 4. Uncomment Kite adapter code
# See src/adapters/kite_adapter.py for detailed instructions

# 5. Authenticate
# Run authentication flow to get access_token

# 6. Start with dry-run
DRY_RUN=true

# 7. Test with small orders
# Place 1-share orders first

# 8. Go live
DRY_RUN=false