gregoshop/tvscreener-rs repository overview

⁠tvscreener-rs

Unofficial Rust TradingView Screener client image: CLI, TUI, and MCP (Streamable HTTP).

Port of deepentropy/tvscreener⁠. Not affiliated with TradingView. Use is subject to TradingView’s terms⁠.

Source: Interchouette-ITC/tvscreener-rs⁠

⁠What’s inside

Size-optimized multi-stage build → distroless cc-debian13 (Debian 13, non-root; no apt/perl/shell). TLS via rustls (no OpenSSL package).

⁠Quick start

docker pull interchouette/tvscreener-rs:dev

# MCP alone (Streamable HTTP on :8787 → /mcp)
docker run -d -p 8787:8787 interchouette/tvscreener-rs:dev

# TUI + MCP (default when attached with a TTY)
docker run -it -p 8787:8787 interchouette/tvscreener-rs:dev

# Interactive CLI + MCP
docker run -it -p 8787:8787 interchouette/tvscreener-rs:dev tvscreener

# One-shot CLI (print and exit; MCP not started)
docker run --rm interchouette/tvscreener-rs:dev tvscreener --help
docker run --rm interchouette/tvscreener-rs:dev tvscreener payload crypto --limit 2
docker run --rm interchouette/tvscreener-rs:dev tvscreener scan crypto --limit 5

⁠Environment

AI clients that support Streamable HTTP can use http://localhost:8787/mcp when the port is published.

⁠Tags

⁠Features (library + tools)

• Query Stock, Crypto, Forex, Bond, Futures, and Coin screeners
• 13,000+ fields embedded in the catalog
• Fluent builders, field presets, async HTTP (reqwest + rustls)
• CLI table/json output, TUI builder + codegen, MCP for AI assistants

⁠Docs

• Repo docs: github.com/Interchouette-ITC/tvscreener-rs⁠
• Docker details: docker/README.md⁠
• Website: interchouette.net⁠

⁠License / disclaimer

See the repository for license terms. This project is not affiliated with TradingView.