股票市场分析服务器

Your Broker Accounts  ──►  Stock MCP Server  ──►  Claude / Cursor AI
    (Upstox, Rupeezy)        (Express + SSE)       (Portfolio Analysis)

pnpm install
pnpm build

cp .env.example .env

PORT=3001

# Upstox (https://account.upstox.com/developer/apps)
UPSTOX_API_KEY=your_client_id
UPSTOX_API_SECRET=your_client_secret

# Rupeezy (https://vortex.rupeezy.in/login)
RUPEEZY_APPLICATION_ID=your_app_id
RUPEEZY_API_SECRET=your_api_secret

node dist/index.js
# or dev mode with auto-reload
pnpm dev

{
  "mcpServers": {
    "stock-mcp": {
      "command": "npx",
      "args": ["mcp-remote", "http://localhost:3001/sse"]
    }
  }
}

> Show all my stock holdings across brokers

> Which stocks am I holding in Upstox?

> What's my total invested value and current portfolio value?

> List my top 5 holdings by current value

> Analyze my portfolio — show P&L, top gainers, top losers

> What's my portfolio diversification score? Am I too concentrated in any stock?

> Which stocks are dragging my portfolio down the most?

> Compare my Upstox vs Rupeezy portfolio performance

> Do I have any open positions today?

> Show my intraday positions and their P&L

> What's my total day P&L across all brokers?

> What's the current price of Reliance? (instrument: NSE_EQ|INE002A01018)

> Get me a real-time quote for TCS including volume and day change

> Show OHLC data for Infosys today

> Show me daily candle data for HDFC Bank for the last 30 days

> Get weekly historical data for Nifty 50 from Jan to March 2025

> Fetch 15-minute candles for Reliance for yesterday

> How much available margin do I have?

> Show my account balance and collateral across all brokers

> What's my total fund balance in Upstox?

> Fetch my portfolio, then analyze which sectors I'm overweight in
  based on the stocks I hold

> Get my holdings and current prices, then calculate which stocks
  have fallen more than 10% from my buy price

> Show my portfolio analysis and suggest which positions I might
  consider rebalancing for better diversification

┌─────────────┐    ┌──────────────┐    ┌──────────────┐
│   Browser    │───►│  MCP Server  │───►│ Broker OAuth │
│  localhost   │◄───│  :3001       │◄───│ Upstox/Rupzy │
└─────────────┘    └──────┬───────┘    └──────────────┘
                          │
                   ┌──────▼───────┐
                   │ Claude/Cursor│
                   │  (MCP SSE)   │
                   └──────────────┘

src/
├── index.ts                    # Entry point — starts Express server
├── server.ts                   # Express app with SSE + OAuth + REST API
├── config.ts                   # Environment config loader
├── types/                      # Unified type definitions
│   ├── portfolio.ts            #   Holding, Position
│   ├── market.ts               #   StockQuote, OHLCVCandle
│   ├── funds.ts                #   FundsInfo
│   └── common.ts               #   BrokerSource
├── brokers/
│   ├── broker.interface.ts     # IBroker contract
│   ├── upstox/
│   │   ├── client.ts           #   Upstox adapter (upstox-js-sdk)
│   │   ├── mapper.ts           #   Response mappers
│   │   └── auth.ts             #   OAuth helpers
│   └── rupeezy/
│       ├── client.ts           #   Rupeezy adapter (@rupeezy/jsvortex)
│       ├── mapper.ts           #   Response mappers
│       └── auth.ts             #   OAuth helpers
├── services/                   # Business logic layer
│   ├── portfolio.service.ts    #   Holdings & positions aggregation
│   ├── market.service.ts       #   Quotes & historical data
│   ├── funds.service.ts        #   Account balance & margin
│   └── analysis.service.ts     #   P&L, diversification, risk
├── views/                      # Dashboard view components
│   ├── index.ts                #   Composes all views
│   ├── layout.ts               #   HTML shell, header, nav, footer
│   ├── dashboard.view.ts       #   Broker cards + MCP config
│   ├── portfolio.view.ts       #   Holdings table
│   ├── positions.view.ts       #   Positions table
│   ├── funds.view.ts           #   Funds cards
│   ├── tools.view.ts           #   Tool testing UI
│   └── scripts.ts              #   Client-side JavaScript
├── tools/                      # MCP tool definitions
└── utils/                      # Logger, cache, rate limiter