Skip to main content

CodeView MCP 🪄

Powered by MCP, CodeLlama-13B (local), Llama-3.1-8b-instant (cloud)

PyPI
CI


1 Why

Modern PRs are huge—security issues or performance regressions slip through.
ReviewGenie does a 30-second AI review:

  • Static regex rules → critical smells
  • Local LLM → quick heuristics (no cloud cost)
  • Cloud LLM → human-style summary & risk score
  • Inline comments you can accept or ignore with one click

2 What it does

Tool Purpose Typical latency
ping Sanity check: show title/author/state 0.3 s
ingest Fetch diff JSON + SQLite cache 1–2 s
analyze Summary, smells[], rule_hits[], risk_score ∈ [0–1] 6–10 s
inline Posts or previews comments 0.5 s
check CI gate (risk_score > threshold) 0.2 s
generate_tests Stub pytest files + open PR 4–6 s

Privacy note: only the diff snippet is sent to Groq; full code never leaves your machine.


3 Quick Start (5 min)

git clone https://github.com/mann-uofg/codeview-mcp.git
cd codeview-mcp
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
pip install -e .

# one-liner smoke
reviewgenie/codeview ping https://github.com/psf/requests/pull/6883

Store secrets once (env-var OR keyring):

from codeview_mcp.secret import set_in_keyring

set_in_keyring("GH_TOKEN",        "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")    #GitHub PAT  
set_in_keyring("OPENAI_API_KEY",  "gsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx")              # Groq/OpenAI key  
set_in_keyring("OPENAI_BASE_URL", "https://api.groq.com/openai/v1")

Full tutorial: docs/QUICKSTART.md


4 Architecture

pipeline

  • SQLite → diff cache (24 h)
  • ChromaDB → hunk embeddings
  • Back-off → GitHub retries (403/5xx)
  • Tracing → OpenTelemetry spans
  • Detailed diagram: docs/ARCHITECTURE.md

5 Benchmark

See bench/benchmarks.md: 10 popular OSS PRs → avg ⏱ 8.1 s analyze, 💰 $0.0008 Groq cost, 96 % comment acceptance.


6 Docs


7 Day-by-Day Log

Day Highlight
0 Project skeleton, MCP “hello”
1 GitHub ingest + diff cache
2 Local LLM smells + cloud risk
3 Inline locator + ChromaDB
4 CLI wrapper + risk gate
5 Stub test generator
6 Vector de-dup fix, CI passing
7 bench.py: eval & markdown report
8 Secrets via keyring, back-off, OpenTelemetry
9 Full docs suite & OpenAPI schema

Full changelog: docs/CHANGELOG.md


8 Roadmap

  • 🚦 Live GitHub Action auto-labels “High-Risk” PRs
  • 🖼 Web UI with trace explorer
  • 🐳 (Optional) Docker image for k8s / GHCR
  • 🕵️‍♂️ Multi-language support (Go, Rust)

Star the repo ⭐ & drop an issue if you’d like to help!

Metadata

Release files for reviewgenie-mcp 1.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for reviewgenie-mcp 1.3.0
File Size Uploaded
reviewgenie_mcp-1.3.0.tar.gz 17.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for reviewgenie-mcp 1.3.0
File Interpreter ABI Platform
reviewgenie_mcp-1.3.0-py3-none-any.whl Python 3 none any Details

Total release size: 34.7 kB

Release files / reviewgenie_mcp-1.3.0.tar.gz

Download URL reviewgenie_mcp-1.3.0.tar.gz
Size 17.1 kB
Tags Source
SHA-256 checksum
How to use checksums
d194d397c4ecb57a9bb259ff344e30beb6ca912a1ebc2308aab93d6e1db14677
BLAKE2b-256 checksum
How to use checksums
2c7bff7ab8dde2d5444687dff3e8cfaa336deb9e45c00d992dd28641af732f44
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.1

Release files / reviewgenie_mcp-1.3.0-py3-none-any.whl

Download URL reviewgenie_mcp-1.3.0-py3-none-any.whl
Size 17.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1100250c6747fa0333ccef085f5f04f90648d7ab9cc891348ae14cd53d231578
BLAKE2b-256 checksum
How to use checksums
72045d052741c9f768bbb45a950ae8501acd954f1e6531044c7370a1899fc042
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.1

Release history Release notifications | RSS feed

This release

1.3.0 This release

2 release files

1.2.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page