# india-stock-mcp

Даёт агенту котировки NSE и BSE, отчётность компаний, NAV паевых фондов, опционные цепочки и список IPO. Ключи API не нужны.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Автор: Akhilgovind02
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/Akhilgovind02/india-stock-mcp
- Обновлён: 2026-06-12
- HTML: https://affpapa.org/nevibecode/mcp/india-stock-mcp

## Что делает

Сервер отдаёт 16 инструментов. `get_quote` показывает цену, объём и диапазон за 52 недели, `get_historical` — историю OHLCV по дням, неделям или месяцам. Есть поиск символа по названию компании, фундаментальные показатели (P/E, EPS, ROE, маржа, долг), сравнение от двух до пяти бумаг и данные по любому индексу NSE плюс SENSEX.

Отдельный блок — фонды и деривативы. `search_funds` ищет по схемам паевых фондов, `get_fund_nav` отдаёт историю NAV, `compare_funds` сопоставляет от двух до четырех фондов по доходности за период. `get_options_chain` строит цепочку вокруг страйка ATM с LTP, открытым интересом, его изменением и подразумеваемой волатильностью. `portfolio_summary` считает текущую стоимость портфеля, P&L и распределение по бумагам.

Нужен Node.js 22 и больше ничего: источники бесплатные, авторизации нет. Данные идут из Yahoo Finance, NSE India и mfapi.in, поэтому котировки могут отставать на несколько минут — для торговых решений в реальном времени это не подходит. Часть эндпоинтов NSE больше не открыта публично, и сервер сам переключается на Yahoo. При активных запросах NSE может ограничить доступ. Список бумаг для `get_gainers_losers` зашит в `NIFTY50_SYMBOLS` в `src/index.ts`, а индекс NSE пересобирает примерно дважды в год — тогда список придётся обновить руками.

## Требования
- Нужно: Node.js (команды через npx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add india-stock-mcp -- npx -y india-stock-mcp
```

### Codex

**Командой платформы**
```bash
codex mcp add india-stock-mcp -- npx -y india-stock-mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "india-stock-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "india-stock-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "india-stock-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "india-stock-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add india-stock-mcp npx -y india-stock-mcp
```

## Когда брать
- посмотреть котировку бумаги и её удалённость от годового максимума
- сравнить фундаментальные показатели двух-трёх банков
- найти бумаги NIFTY 50 с наибольшим ростом за день
- оценить, где в опционной цепочке NIFTY скопился открытый интерес
- посчитать доходность портфеля из списка бумаг с ценами покупки

## Примеры запросов агенту
- Котировка RELIANCE и насколько она ниже 52-недельного максимума?
- Сравни фундаментальные показатели HDFC Bank, ICICI Bank и SBI
- Покажи опционную цепочку NIFTY и где максимальный открытый интерес

## Похожие
- [World Monitor](https://affpapa.org/nevibecode/mcp/world-monitor.md) — MCP-сервер · ★ 89408
- [CCXT](https://affpapa.org/nevibecode/mcp/ccxt.md) — MCP-сервер · ★ 44583
- [Finance Toolkit](https://affpapa.org/nevibecode/mcp/finance-toolkit.md) — MCP-сервер · ★ 5458
- [EdgarTools](https://affpapa.org/nevibecode/mcp/edgartools.md) — MCP-сервер · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/nevibecode/mcp/letsfg-flights-hotels.md) — MCP-сервер · ★ 2188
- [AutoTS](https://affpapa.org/nevibecode/mcp/autots.md) — MCP-сервер · ★ 1434

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md