Memungkinkan AI agent untuk melakukan stock screening yang deterministik, backtesting historis, dan analisis faktor Fama-French menggunakan data pasar riil.
Juga dikenal sebagai zomma-dev/quantcontext-mcp-server, quantcontext-mcp-server, quantcontext-mcp
- Stars
- 10
- Tools
- 3
- Unduhan, 30 hari
- 268
- Versi terbaru
- 0.1.2
- Commit terakhir
- 21 Okt 2026
- Lisensi
- MIT
Apa itu QuantContext MCP?
QuantContext adalah MCP server. Memungkinkan AI agent untuk melakukan stock screening yang deterministik, backtesting historis, dan analisis faktor Fama-French menggunakan data pasar riil. Server ini menyediakan 3 tool, seperti screen_stocks, backtest_strategy, factor_analysis.
Ringkasan dibuat dari README proyek
Tentang QuantContext MCP server
Melakukan riset kuantitatif dan stock screening melalui bahasa alami adalah apa yang dimungkinkan oleh QuantContext bagi developer yang menggunakan Claude, Codex, atau OpenCode. Ini memungkinkan pengguna untuk mengubah deskripsi strategi dalam bahasa Inggris biasa menjadi workflow riset yang dapat dieksekusi menggunakan data pasar riil, bukan sekadar angka buatan. Server ini beroperasi secara lokal tanpa memerlukan API key atau konfigurasi yang rumit, dengan mengambil data dari sumber seperti Yahoo Finance dan Kenneth French Data Library.
Pengguna dapat mengakses tiga tool utama untuk membangun pipeline riset yang lengkap. Tool screen_stocks menyaring universe seperti S&P 500 atau Nasdaq 100 menggunakan sinyal fundamental, momentum, atau teknikal. Tool backtest_strategy mengevaluasi pilihan tersebut selama periode historis untuk menghitung metrik seperti CAGR, Sharpe ratio, dan maximum drawdown. Terakhir, tool factor_analysis mendekomposisi return ke dalam faktor Fama-French untuk menentukan apakah sebuah strategi menghasilkan alpha yang sesungguhnya atau hanya sekadar mencerminkan eksposur pasar. Setup ini sangat ideal bagi trader dan peneliti yang membutuhkan hasil deterministik yang dapat direproduksi langsung di dalam lingkungan coding agent mereka.
Apa yang bisa Anda lakukan dengannya
- 1Filter saham berdasarkan metrik spesifikMinta agent untuk mencari perusahaan S&P 500 dengan price-to-earnings ratio yang rendah dan return on equity yang tinggi.
- 2Validasi strategi trading secara historisUji bagaimana strategi berbasis momentum pada Nasdaq 100 akan berkinerja selama dua tahun terakhir dengan rebalancing bulanan.
- 3Analisis driver returnTentukan apakah performa sebuah strategi disebabkan oleh alpha yang asli atau eksposur terhadap faktor Fama-French tertentu.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal QuantContext MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal QuantContext MCP di Claude Code
$ claude mcp add quantcontext-mcp-server -- uvx quantcontext-mcpInstal QuantContext MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"quantcontext-mcp-server": {
"command": "uvx",
"args": [
"quantcontext-mcp"
]
}
}
}Instal QuantContext MCP di VS Code
.vscode/mcp.json
{
"servers": {
"quantcontext-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"quantcontext-mcp"
]
}
}
}Instal QuantContext MCP di VS Code CLI
$ code --add-mcp '{"name":"quantcontext-mcp-server","type":"stdio","command":"uvx","args":["quantcontext-mcp"]}'Instal QuantContext MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"quantcontext-mcp-server": {
"command": "uvx",
"args": [
"quantcontext-mcp"
]
}
}
}Instal QuantContext MCP di Codex
$ codex mcp add quantcontext-mcp-server -- uvx quantcontext-mcpInstal QuantContext MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.quantcontext-mcp-server] command = "uvx" args = ["quantcontext-mcp"]
Instal QuantContext MCP di Gemini CLI
$ gemini mcp add -s user quantcontext-mcp-server uvx -- quantcontext-mcpInstal QuantContext MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"quantcontext-mcp-server": {
"command": "uvx",
"args": [
"quantcontext-mcp"
]
}
}
}Tool QuantContext MCP 3
Terdeteksi dari READMEscreen_stocksbacktest_strategyfactor_analysis
| screen_stocks | — | |
| backtest_strategy | — | |
| factor_analysis | — |
Pengecekan otomatis
Berjalan 13 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkauLolos
- Lisensi open source (OSI)Lolos
- Ada commit atau release dalam satu tahun terakhirLolos
- Nama package tidak mirip dengan package populerLolos
- Remote endpoint menggunakan HTTPSTidak diperiksa
- Tools yang bersifat destruktif telah diberi labelLolos
- Tidak ada instruksi tersembunyi untuk modelLolos
- Tidak ada advisory kritis pada paket atau dependensinyaLolos
README
Lihat di GitHubQuantContext
QuantContext is an MCP server that turns plain-English strategy descriptions into executable quant research: screen stocks by any criteria, backtest over historical data, and run factor analysis to see where the returns come from. Every number is computed from real market data, not generated by an LLM. Results are fully reproducible.
Works with Claude, Codex, OpenCode, or any other MCP-compatible coding agent.
Install
pip install quantcontext-mcp
Claude Code:
claude mcp add quantcontext -- quantcontext
Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"quantcontext": {
"command": "quantcontext"
}
}
}
No API keys. No configuration.
Tools
Three tools that compose into a full research workflow:
screen_stocks -> backtest_strategy -> factor_analysis
| Tool | What it does |
|---|---|
screen_stocks |
Filter S&P 500, Nasdaq 100, or Russell 2000 by fundamentals, momentum, quality, technical signals, or a multi-factor blend. Returns ranked candidates. |
backtest_strategy |
Test a strategy over history with a rebalance-loop engine. Returns CAGR, Sharpe, max drawdown, equity curve, and trade log. |
factor_analysis |
Decompose strategy returns into Fama-French factors (market, size, value, momentum). Returns alpha with t-statistic, factor loadings, and R-squared. |
Sample Prompts
Stock screening:
Screen S&P 500 for value stocks: PE under 15, ROE above 12%
Find the top 20% momentum stocks in the Nasdaq 100 over the last 200 days
Rank S&P 500 stocks by a blend of value, momentum, and quality, equal weight each factor
Find S&P 500 stocks with RSI under 40 and price above the 200-day moving average
Backtesting:
Backtest a top-20% momentum strategy on Nasdaq 100, monthly rebalance, last 2 years
How would a value screen (PE under 15, ROE above 12%) have performed on S&P 500 over the last 3 years?
Test a momentum strategy with a 15% stop loss and 20% max portfolio drawdown circuit breaker
Full research workflow:
Screen S&P 500 for cheap, high-quality stocks. Backtest monthly over 3 years,
then run factor analysis. Is the return real alpha or just factor exposure?
Screen Types
| Screen | Description | Key parameters |
|---|---|---|
fundamental_screen |
Filter by PE, ROE, leverage, revenue growth | pe_lt, roe_gt, debt_equity_lt, revenue_growth_gt |
quality_screen |
Profitability and balance sheet health | roe_gt, debt_equity_lt, profit_margin_gt |
momentum_screen |
Rank by N-day price momentum | lookback_days, top_pct |
value_screen |
Cheapest stocks by valuation | pe_lt, top_n |
factor_model |
Multi-factor composite score | weights (value/momentum/quality/volatility), top_n |
technical_signal |
RSI and SMA crossover signals | rsi_period, sma_short, sma_long |
mean_reversion |
Stocks below z-score threshold | lookback_days, z_threshold |
Use from Python
The tools are also importable directly — no agent required. Useful if you have an existing script and want to plug in backtesting or factor analysis.
from quantcontext.server import screen_stocks, backtest_strategy, factor_analysis
import asyncio, json
# Screen
result = json.loads(asyncio.run(screen_stocks(
universe="sp500",
screen_type="fundamental_screen",
config={"pe_lt": 15, "roe_gt": 12},
)))
# Backtest
bt = json.loads(asyncio.run(backtest_strategy(
stages=[{"order": 1, "type": "screen", "skill": "fundamental_screen", "config": {"pe_lt": 15, "roe_gt": 12}}],
universe="sp500",
rebalance="monthly",
start_date="2022-01-01",
)))
print(bt["metrics"])
# Factor analysis — pipe the equity curve straight in
fa = json.loads(asyncio.run(factor_analysis(
equity_curve=bt["full_equity_curve"]
)))
print(fa["alpha_annualized"], fa["alpha_tstat"])
Strategies are expressed using the built-in screen types from the table above. All functions are async and return JSON strings.
Data
All public data, no API keys required.
| Data | Source | Cache |
|---|---|---|
| Daily OHLCV prices | Yahoo Finance (yfinance) |
~/.cache/quantcontext/prices.parquet |
| Fundamentals (PE, ROE, margins, etc.) | Yahoo Finance | ~/.cache/quantcontext/financials/, 24h TTL |
| Fama-French factors (Mkt-RF, SMB, HML, Mom) | Kenneth French Data Library | ~/.cache/quantcontext/ff_factors.parquet |
| Universe lists (S&P 500, Nasdaq 100) | Wikipedia | ~/.cache/quantcontext/sp500_tickers.json |
The first tool call downloads and caches data (10-30 seconds). All subsequent calls use the local cache: screening under 1s, backtesting 3-8s.
To skip the cold start, run once after install:
quantcontext-warmup --url https://quantcontext.ai/api/data
Links
License
MIT
Pertanyaan tentang QuantContext MCP
Bagaimana cara menambahkan QuantContext MCP ke Claude Code?
Jalankan claude mcp add quantcontext-mcp-server -- uvx quantcontext-mcp di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan QuantContext MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Tool apa yang disediakan QuantContext MCP?
Server ini menyediakan 3 tool, termasuk screen_stocks, backtest_strategy, factor_analysis.
Apakah server ini memerlukan API key?
Tidak, server ini tidak memerlukan API key atau konfigurasi apa pun untuk dapat bekerja.
Bisakah saya menggunakan tool ini di dalam script Python saya sendiri?
Ya, tool ini dapat di-import secara langsung untuk digunakan dalam script Python yang sudah ada tanpa memerlukan AI agent.
Berapa lama waktu yang dibutuhkan untuk mendapatkan data?
Pemanggilan tool pertama kali akan mengunduh dan menyimpan data di cache, yang memakan waktu 10-30 detik, namun pemanggilan berikutnya akan menggunakan cache lokal untuk hasil yang jauh lebih cepat.