MCP TradingView Server
FastMCP v2 server that exposes TradingView technical indicators and OHLCV data through the tradingview_scraper library. The mcp-tradingview console entry powers Claude Desktop or any MCP-aware client.
Quick Start
Automated Setup (Recommended)
- Install uv and Python 3.11+
- Run the setup script:
./setup.sh- Installs dependencies and creates virtual environment
- Automatically configures Claude Desktop with the MCP server
- Restart Claude Desktop to load the new configuration
Manual Setup
- Install uv and Python 3.11+
uv venv --python 3.11 && source .venv/bin/activateuv pip install -e .- Configure Claude Desktop (see below)
Running
- Stdio (Claude default):
uv run mcp-tradingview - SSE service:
uv run mcp-tradingview --transport sse --host 0.0.0.0 --port 8000 - HTTP service:
uv run mcp-tradingview --transport http --host 0.0.0.0 --port 8000 --path /mcp
FASTMCP_HOST, FASTMCP_PORT, and FASTMCP_PATH environment variables override the bind settings when present.
Tools
get_indicators(symbol, exchange="BINANCE", timeframe="1h", all_indicators=True, export_result=False)– full TradingView indicator snapshot; returnssuccess,symbol,exchange,timeframe, and anindicatorsmapping.get_specific_indicators(symbol, indicators, exchange="BINANCE", timeframe="1h", export_result=False)– filters the full snapshot to requested keys (case-insensitive) and echoesrequested_indicators.get_historical_data(symbol, exchange="BINANCE", timeframe="1h", max_records=100, export_result=False)– streams OHLCV candles viaStreamer, returningrecords_collected,data, and optionalexport_file.
Resources & Exports
- Resource
indicators/{symbol}emits a formatted indicator report usingget_indicatorsdefaults. - When
export_result=True, JSON payloads are written toexport/; keep large archives out of version control.
Claude Desktop
Add the server to claude_desktop_config.json. Here are the recommended configurations:
Using Claude Code CLI (Easiest)
claude mcp add tradingview -- uvx --from /absolute/path/to/mcp-tradingview-server mcp-tradingview
Or with uv run:
claude mcp add tradingview -- uv run mcp-tradingview --cwd /absolute/path/to/mcp-tradingview-server
Manual Configuration
Stdio Transport (Recommended)
{
"mcpServers": {
"tradingview": {
"command": "uvx",
"args": ["--from", "/absolute/path/to/mcp-tradingview-server", "mcp-tradingview"]
}
}
}
Alternative with uv run:
{
"mcpServers": {
"tradingview": {
"command": "uv",
"args": ["run", "mcp-tradingview"],
"cwd": "/absolute/path/to/mcp-tradingview-server"
}
}
}
HTTP Transport
{
"mcpServers": {
"tradingview": {
"command": "uv",
"args": ["run", "mcp-tradingview", "--transport", "http", "--host", "0.0.0.0", "--port", "8001", "--path", "/mcp"],
"cwd": "/absolute/path/to/mcp-tradingview-server"
}
}
}
Restart Claude Desktop after updating the configuration. The bundled CLAUDE.md provides extra guidance the model can reference while chatting.
Development
uv run pytestexecutes the asynchronous test suite intest_server.py.- Use
logging.getLogger(__name__)for diagnostics; avoid printing secrets. - Refer to
export/for captured fixtures when updating tests or documentation.
License
This project is provided as-is for educational and research purposes.
Metadata
Release files for iflow-mcp_bidouilles_mcp-tradingview-server 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_bidouilles_mcp_tradingview_server-0.1.0.tar.gz | 11.7 kB | Without provenance | Details for iflow_mcp_bidouilles_mcp_tradingview_server-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_bidouilles_mcp_tradingview_server-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_bidouilles_mcp_tradingview_server-0.1.0-py3-none-any.whl |
Total release size: 17.4 kB
Release files / iflow_mcp_bidouilles_mcp_tradingview_server-0.1.0.tar.gz
| Download URL | iflow_mcp_bidouilles_mcp_tradingview_server-0.1.0.tar.gz |
|---|---|
| Size | 11.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
12ab4a31deea9073f65ae1c7bcb659423ad1a1bbba4bb05795b9bdadc931ebd4
|
|
BLAKE2b-256 checksum How to use checksums |
a6a24c95ad05388d0be5b08ef01a6912fe88ce9eacfeb91e1cccd0d289e30e97
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.28 {"installer":{"name":"uv","version":"0.9.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_bidouilles_mcp_tradingview_server-0.1.0-py3-none-any.whl
| Download URL | iflow_mcp_bidouilles_mcp_tradingview_server-0.1.0-py3-none-any.whl |
|---|---|
| Size | 5.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1f6e477ac240d26fba43ec7de73cc6a76dc590c27d6fdb8f118a18e0e43adabe
|
|
BLAKE2b-256 checksum How to use checksums |
4963ae7cef58651954c566eb1948c1fe7c873b0b573090f6a02fdcc0990e71fd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.28 {"installer":{"name":"uv","version":"0.9.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_bidouilles_mcp-tradingview-server 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.