tradingview-mcp-aibridge

# Tool List **tradingview-mcp by AI BRIDGE** — MCP server connecting TradingView Desktop to Claude Code. Reads and controls running TradingView charts directly through Chrome DevTools Protocol (CDP). ### Specialized Version for Korean Traders - ✅ **Windows MSIX Native Support** — Automatic path detection using `Get-AppxPackage` - ✅ **Upbit/Bithumb/Binance Symbols Included** — Korean won pairs available out-of-the-box - ✅ **Kimchi Premium Auto-Calculation Tool** — New tool: `kimchi_premium` - ✅ Includes all existing TradingView control tools ## One-Shot Setup Copy and paste the following prompt into Claude Code: ``` Set up tradingview-mcp-aibridge for me. Clone https://github.com/aibridge-leo/tradingview-mcp-aibridge.git into the current project directory. Run npm install inside it. Create .mcp.json in the project root with: { "mcpServers": { "tradingview": { "command": "node", "args": ["<ABSOLUTE_PATH_TO_CLONED_DIR>/src/server.js"] } } } Tell me to: (1) launch TradingView with scripts/launch_tv_debug.bat on Windows (auto-detects MSIX install), (2) restart Claude Code, (3) run tv_health_check to verify. ``` > If you want to use your own fork, replace the clone URL with your repository. ## Prerequisites - **Windows / macOS / Linux** (Windows MSIX installation officially supported) - **Node.js 18+** - **Claude Code** (Pro plan recommended) - **TradingView Account** (free accounts allowed, paid accounts offer more features) ## Manual Installation See [SETUP.md](./SETUP.md) for detailed instructions. ## Usage Examples In Claude Code, use natural language: ``` "Tell me my chart status" → chart_get_state, data_get_study_values automatically called "Show me BTC on a 4-hour chart" → chart_set_symbol, chart_set_timeframe "What's the kimchi premium for BTC?" ← AI BRIDGE addition → kimchi_premium (UPBIT:BTCKRW, BINANCE:BTCUSDT, USD/KRW automatically compared) "Find and fix bugs in this Pine Script" → pine_get_source, pine_set_source, pine_smart_compile ``` ## Key Features | Category | Tool Examples | |---|---| | **Chart Reading** | `chart_get_state`, `data_get_study_values`, `quote_get`, `data_get_ohlcv` | | **Chart Manipulation** | `chart_set_symbol`, `chart_set_timeframe`, `chart_manage_indicator` | | **Pine Script** | `pine_set_source`, `pine_smart_compile`, `pine_get_errors` | | **Drawing** | `draw_shape`, `draw_list`, `draw_clear` | | **Replay** | `replay_start`, `replay_step`, `replay_trade`, `replay_status` | | **Alerts** | `alert_create`, `alert_list`, `alert_delete` | | **Batching** | `batch_run` (multiple symbols × timeframes) | | **Korean Specialized** | `kimchi_premium` (kimchi premium calculation) | See [CLAUDE.md](./CLAUDE.md) for the full list and tool selection guide. ## Korean Trader Defaults ### Symbol Notation | Asset | Upbit | Bithumb | Binance | |---|---|---|---| | Bitcoin | `UPBIT:BTCKRW` | `BITHUMB:BTCKRW` | `BINANCE:BTCUSDT` | | Ethereum | `UPBIT:ETHKRW` | `BITHUMB:ETHKRW` | `BINANCE:ETHUSDT` | | Solana | `UPBIT:SOLKRW` | `BITHUMB:SOLKRW` | `BINANCE:SOLUSDT` | ## Project Structure ``` tradingview-mcp-aibridge/ ├── src/ │ ├── server.js # MCP server entry point │ ├── core/ # CDP client + tool logic │ │ └── korean.js # 🇰🇷 kimchi premium calculation │ ├── tools/ # MCP tool wrappers │ │ └── korean.js # 🇰🇷 kimchi_premium tool │ └── cli/ # `tv` CLI ├── scripts/ │ ├── launch_tv_debug.bat # Windows MSIX auto-detection launcher │ └── launch_tv_debug.ps1 # launcher logic (PowerShell) ├── agents/ # Claude Code sub-agents ├── skills/ # workflow skills ├── CLAUDE.md # tool selection guide (automatically loaded by Claude) ├── SETUP.md # detailed installation guide ├── package.json ├── LICENSE └── README.md # this file ``` ## Important Notes - This project is a **non-official tool** and has no affiliation with TradingView Inc. or Anthropic PBC. - CDP-based desktop automation is not explicitly allowed by TradingView's terms of service. We recommend using a **test account** instead of your main account. - Before connecting to live trading automation (e.g., webhooks), **verify with small amounts**. - Users are responsible for ensuring their usage complies with TradingView's terms of service and relevant laws. ## Credits This project is built on top of: - Original: [tradesdontlie/tradingview-mcp](https://github.com/tradesdontlie/tradingview-mcp) — project that laid the foundation for connecting TradingView Desktop to Claude Code - Immediate fork: [LewisWJackson/tradingview-mcp-jackson](https://github.com/LewisWJackson/tradingview-mcp-jackson) — added one-shot setup structure AI BRIDGE fork additions: - Windows MSIX native support (`Get-AppxPackage`-based launcher) - `kimchi_premium` tool (Upbit ↔ Binance ↔ USD/KRW automatic calculation) - Korean documentation ## License MIT License. See [LICENSE](./LICENSE) for details. - Copyright (c) 2026 tradesdontlie (original author) - Copyright (c) 2026 AI BRIDGE (this fork's modifications) ## Contributions Issues and PRs are welcome. When reporting bugs, please include your Windows version, TradingView Desktop version, and Node.js version.