gitpr-cli 0.0.27__py3-none-any.whl → 0.0.29__py3-none-any.whl

{gitpr_cli-0.0.27.dist-info → gitpr_cli-0.0.29.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitpr-cli
-Version: 0.0.27
+Version: 0.0.29
 Summary: Automação de PRs, Commits e Code Review com IA (Gemini e DeepSeek)
 Author-email: Natan Fiuza <contato@natanfiuza.dev.br>
 Requires-Python: >=3.10
@@ -14,17 +14,20 @@ Requires-Dist: cryptography
 Requires-Dist: pyyaml
 Requires-Dist: textual
 Requires-Dist: requests
+Requires-Dist: mcp>=1.0.0
 Dynamic: license-file
 
 
 # **GitPR CLI 🚀**
 
 <p align="center">
-  <img src="docs/logo.png" alt="GitPR Logo" width="200">
+  <img src="https://raw.githubusercontent.com/natanfiuza/gitpr/main/docs/logo.png" alt="GitPR Logo" width="150">
 </p>
 
 GitPR CLI is a command-line automation tool that uses **Google Gemini** and **DeepSeek** artificial intelligence to analyze your code changes (git diff) or entire files. The tool automatically generates commit messages in the *Conventional Commits* standard, detailed Pull Request descriptions, and deep Code Reviews aimed at reducing technical debt.
 
+🌐 **Website:** [gitpr.natanfiuza.dev.br](https://gitpr.natanfiuza.dev.br/) · 📂 **Repository:** [github.com/natanfiuza/gitpr](https://github.com/natanfiuza/gitpr)
+
 ## **🛠️ Technologies and Libraries Used**
 
 This project was developed in Python and uses the following main libraries:
@@ -38,6 +41,7 @@ This project was developed in Python and uses the following main libraries:
 * [**PyYAML**](https://pyyaml.org/): Used to read and process the custom static analysis rules from the `.gitpr.linter.yml` file.
 * [**Textual**](https://textual.textualize.io/): Powerful library for creating Terminal Graphical Interfaces (TUI), used in the interactive issue generation and editing panel.
 * [**Requests**](https://pypi.org/project/requests/): Elegant and robust library for HTTP requests, used to communicate with the GitHub REST API.
+* [**MCP**](https://pypi.org/project/mcp/): Official Python SDK for the Model Context Protocol, enabling GitPR to integrate directly with AI-powered editors and IDEs.
 
 ----
 
@@ -135,6 +139,8 @@ You can pass the following *flags* for specific actions:
 * `--lang <code>`: Forces the interface language for this execution (e.g.: `en_us`, `pt_br`). Overrides `GITPR_LANG` in `.env` without persisting the change.
 * `-ch` or `--chat`: Opens the **Interactive Pair Programming Chat** — a TUI terminal where the AI sees your current diff and maintains a contextual conversation. Features memory per branch, slash commands (`/explain`, `/tests`, `/optimize`, `/clear`), auto-patching (F5), diff refresh (F2), and session export (F6).
 * `-l` or `--linter`: Runs **only the local static linter** (no AI calls). Ideal for use in CI/CD pipelines to block non-compliant code.
+* `--mcp`: Starts GitPR as an **MCP server** (Model Context Protocol) on stdio transport. Enables integration with VS Code, Cursor, Claude Desktop, and other MCP-compatible editors — exposing all GitPR AI capabilities as 10 annotated tools, 15 resources, and 7 pre-built prompts directly inside your IDE. Also available as the standalone `gitpr-mcp` command.
+* `--install`: **Interactive Setup Wizard.** Runs a guided 4-step setup: downloads skill templates, installs Git hooks, configures MCP for detected editors, and checks/requests your AI provider API key. Each step asks for confirmation before proceeding.
 * `-ih` or `--installhooks`: Automatically installs **local Git Hooks** (`pre-commit` and `prepare-commit-msg`) in your repository.
 * `-s` or `--skill`: Creates the AI context template files (`.gitpr.commit.md`, `.gitpr.pr.md`, `.gitpr.review.md`, `.gitpr.filereview.md`, `.gitpr.issue.md`, `.gitpr.blame.md`) and the Linter (`.gitpr.linter.yml`) at the project root.
 * `-is` or `--issue`: Automatically generates a draft of a **standardized Issue** and opens an interactive interface (TUI) for editing or direct submission via REST API. This feature has **3 context engines** depending on the command combination:
@@ -152,7 +158,7 @@ You can pass the following *flags* for specific actions:
 
 When your diff is too large for a single AI call (over ~90k estimated tokens), GitPR automatically splits it into batches by file, asks the AI for a technical summary of each part (Map), and unifies everything into the final commit message, review, or PR description (Reduce). No flags needed — it activates on demand and shows the progress in the console.
 
-📚 Full documentation: [docs/map-reduce-diff.md](docs/map-reduce-diff.md)
+📚 Full documentation: [docs/map-reduce-diff.md](https://github.com/natanfiuza/gitpr/blob/main/docs/map-reduce-diff.md)
 
 ## 🛡️ Local Linter (Static Analysis)
 
@@ -207,7 +213,66 @@ GitPR automatically detects your system language and displays messages in your n
 
 To force a specific language, set `GITPR_LANG=pt_br` or `GITPR_LANG=en` in `~/.gitpr/.env`.
 
-> 📖 **Full developer guide:** [docs/i18n_explanation.md](docs/i18n_explanation.md) — architecture, usage patterns, circular import precautions, and how to add new languages.
+> 📖 **Full developer guide:** [docs/i18n_explanation.md](https://github.com/natanfiuza/gitpr/blob/main/docs/i18n_explanation.md) — architecture, usage patterns, circular import precautions, and how to add new languages.
+
+## 🔌 MCP Integration (Model Context Protocol)
+
+GitPR can run as an **MCP server**, exposing its AI-powered capabilities as tools that your editor's AI assistant can invoke directly — no terminal needed. This enables a fully integrated workflow where you can generate commit messages, review code, run linters, trace code origins, and create issues without leaving your IDE.
+
+### Supported Editors
+
+| Editor | Config File |
+| ------ | ----------- |
+| **VS Code** | `.vscode/mcp.json` |
+| **Cursor** | `.cursor/mcp.json` |
+| **Claude Code** | `.mcp.json` |
+| **Claude Desktop** | `claude_desktop_config.json` |
+| **Zed** | `settings.json` |
+
+### Quick Setup
+
+Use the built-in installer to configure your editor automatically:
+
+```bash
+gitpr-mcp --install vscode    # Creates .vscode/mcp.json
+gitpr-mcp --install cursor      # Creates .cursor/mcp.json
+gitpr-mcp --install claude-code # Creates .mcp.json
+gitpr-mcp --install claude      # Updates Claude Desktop config
+gitpr-mcp --install zed         # Updates Zed settings
+gitpr-mcp --install auto      # Auto-detect and install for all found
+```
+
+The installer creates the config directory if needed, merges with any existing
+config (never overwrites other servers), and is safe to run multiple times.
+
+> Manual setup is also supported — see [docs/mcp-integration.md](https://github.com/natanfiuza/gitpr/blob/main/docs/mcp-integration.md)
+> for the JSON config format for each editor.
+
+Once configured, use natural language in your editor's AI chat:
+
+   * *"Review my current changes"* → calls `review_code`
+   * *"Generate a commit message"* → calls `generate_commit_message`
+   * *"Create a PR description"* → calls `generate_pr_description`
+   * *"Run the linter on my diff"* → calls `run_linter`
+
+### Available MCP Tools
+
+| Tool | Description |
+| ---- | ----------- |
+| `get_git_context` | Current branch, repository name, and remote URL |
+| `analyze_diff` | Git diff of uncommitted changes |
+| `get_full_diff` | Full diff against origin/main |
+| `generate_commit_message` | AI-generated Conventional Commits message |
+| `review_code` | AI code review of local changes |
+| `full_review` | AI code review of all changes since origin/main |
+| `generate_pr_description` | Complete PR description (title + body) |
+| `run_linter` | Static linter against `.gitpr.linter.yml` |
+| `analyze_blame` | Git blame + AI classification |
+| `generate_issue` | Structured issue from diff, history, or blame |
+
+📖 **Full documentation:** [docs/mcp-integration.md](https://github.com/natanfiuza/gitpr/blob/main/docs/mcp-integration.md) — available in 5 languages (EN, PT-BR, PT-PT, ES, FR).
+
+> 💬 **MCP Prompts** — GitPR also exposes 7 pre-defined message templates (prompts) for common flows like "Review PR", "Generate Commit Message", and "Create Issue from Diff". See the [MCP Prompts guide](https://github.com/natanfiuza/gitpr/blob/main/docs/mcp-prompts.md) for the full list.
 
 ## 📚 Technical Documentation and Advanced Guides
 
@@ -238,10 +303,14 @@ If you want to implement GitPR as an automated quality barrier in your team, che
 
 ### Configuration & Infrastructure
 
+* [**Install Wizard**](https://github.com/natanfiuza/gitpr/blob/main/docs/install-wizard.md) — Step-by-step guided setup for configuring GitPR in a new project.
 * [**AI Providers**](https://github.com/natanfiuza/gitpr/blob/main/docs/providers-ia.md) — Configuration and selection between Google Gemini, DeepSeek, and Ollama.
 * [**Auto-Updater**](https://github.com/natanfiuza/gitpr/blob/main/docs/auto-update.md) — How GitPR's automatic update (hot-swap) works.
 * [**GitHub Token (PAT) Integration and Security**](https://github.com/natanfiuza/gitpr/blob/main/docs/github-pat-integration.md) — Understand how GitPR creates issues directly in the repository with authentication.
 * [**Internationalization (i18n)**](https://github.com/natanfiuza/gitpr/blob/main/docs/i18n_explanation.md) — Architecture, usage patterns, and how to add new languages.
+* [**MCP Integration**](https://github.com/natanfiuza/gitpr/blob/main/docs/mcp-integration.md) — Connect GitPR to VS Code, Cursor, and Claude Desktop via Model Context Protocol.
+* [**MCP Prompts**](https://github.com/natanfiuza/gitpr/blob/main/docs/mcp-prompts.md) — Pre-built message templates (7 prompts, 35 language variants) for common GitPR workflows in your editor's AI chat.
+* [**MCP Tool Annotations**](https://github.com/natanfiuza/gitpr/blob/main/docs/mcp-annotations.md) — IDE integration hints (`readOnlyHint`, `destructiveHint`) for smarter UI behavior and safer tool execution.
 
 ## ⚡ Local Cache System (Quota Savings)
 

{gitpr_cli-0.0.27.dist-info → gitpr_cli-0.0.29.dist-info}/RECORD

@@ -1,25 +1,26 @@
-gitpr_cli-0.0.27.dist-info/licenses/LICENSE,sha256=UQzLC6mwqb-ZNDkBBAqOxC-SMQcEID0gaM6oFcu6u48,27030
+gitpr_cli-0.0.29.dist-info/licenses/LICENSE,sha256=UQzLC6mwqb-ZNDkBBAqOxC-SMQcEID0gaM6oFcu6u48,27030
 src/__init__.py,sha256=U6ksarernNcryHO20aj4rNG7w0thT7xdMs5KzBJyPvE,28
 src/ai_providers.py,sha256=cxPuytZ9LfvhQbWFPBJ4dud3lHLpAQpa3cbY8bKESk8,10954
 src/blame_engine.py,sha256=z-uh8mHOF--JxY_nnbp5r_9y_a_IO4Zn42P0AeLBpto,10436
 src/cache.py,sha256=XggMTy00GlZfeF1VoLEYCdxL5h0eTg11TJfPIRPx7fs,3201
 src/chat_memory.py,sha256=vdYuElIQb6-flFm4SfzapnQZGRIwgbLECzIcsAc0Oo8,8724
 src/config.py,sha256=VJ9ekDlTVG5ETWDuO1kZWlgrncXbrvduxa5Zg7wN_ZY,9064
-src/core.py,sha256=M7dPzenRa7HtOVPvFXltwg3OR2ca2EsJFJY60ajUijg,24297
+src/core.py,sha256=PqwqWHA5h_EplQ6mURxriS5Ql9_QPq73S2R9zJ11-78,28580
 src/i18n.py,sha256=QED7hTSdWCC1lSNJ-l6VuOba18OrWgFTMQcZ7cQmXbY,3599
 src/issue_engine.py,sha256=XJ7WNLoeg3wct079wS7OQqU62f_avn3A8LmMuPWchzE,3642
 src/linter_engine.py,sha256=D04wvOgRa-vZEYknm-z-Cg7V_3gnoQz_64PMorWnISo,4414
-src/main.py,sha256=s-7JO9MudWZ5mqurDtzTtcj8GoMNirlptgbTQ6y6-vU,31742
+src/main.py,sha256=BoI2aN3l1fS4UzoWL67Yw2QtkeRxh9ITuVIQEc9JOPA,32724
+src/mcp_server.py,sha256=rT5ACAb0MUpvt8qfO0jIt3g4y6BKWW5YY2qRrs6hKsQ,40227
 src/security.py,sha256=Li0zM8ZURTK2nKRHIt49TWLO4DIddBEHzXPrVycv0Rs,1343
-src/spinner.py,sha256=16ngB2oT1t7O-c3D2DWCJbFb9nMyD-HWv6KcvhKTelQ,7651
+src/spinner.py,sha256=fnl_jVOPjlC1DmINbnJ_IKW-uujpyJNTv51jwhAMvlc,8466
 src/tui_issue.py,sha256=gcAJCIfMcdeMjrFJUWQQvdgBv7fnOBtxQxwdBk2Sk40,1789
-src/updater.py,sha256=QPvYVEBpORF37rfD2oB_vVKnfNIw5amlaJk3NDSckuA,5886
+src/updater.py,sha256=kHzP-SyprrNQSLeOhiplFjPuswkh4enVc9TM_7LQnpU,5886
 src/ui/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 src/ui/chat_app.py,sha256=y-py5UpisQbPLqqDON8AIkyA7X1IM5LAn1GbeYr2p_U,25598
 src/ui/help_screen.py,sha256=tjbokXhwyzLnkOC0S56NbpX-78hcFQnvsQMpNU1wt0c,1862
 src/ui/issue_app.py,sha256=8MdBcOVdCHPFx6EUhs80CiZ2G-29KulskkCz9qMZ_Lg,4737
-gitpr_cli-0.0.27.dist-info/METADATA,sha256=RaWiAINchrmj4I8CpZxeaObnRVH4IwpEgneVOFCxkG4,18530
-gitpr_cli-0.0.27.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
-gitpr_cli-0.0.27.dist-info/entry_points.txt,sha256=mh_4F_idM4cj0XhfRGBDQb5Nnku93YJ-dyKh5SufwlE,39
-gitpr_cli-0.0.27.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
-gitpr_cli-0.0.27.dist-info/RECORD,,
+gitpr_cli-0.0.29.dist-info/METADATA,sha256=Q77hoxR0vAluySUVwFCFuJPb3-7zozYTPFNm-y2Y1jY,23425
+gitpr_cli-0.0.29.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+gitpr_cli-0.0.29.dist-info/entry_points.txt,sha256=TstGnMUzdOI5qNmpM97EPDBPuMqOZxoo6EoLxHSOMSQ,71
+gitpr_cli-0.0.29.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
+gitpr_cli-0.0.29.dist-info/RECORD,,

{gitpr_cli-0.0.27.dist-info → gitpr_cli-0.0.29.dist-info}/entry_points.txt

@@ -1,2 +1,3 @@
 [console_scripts]
 gitpr = src.main:cli
+gitpr-mcp = src.mcp_server:main

src/core.py

@@ -12,7 +12,7 @@ from google import genai
 from dotenv import load_dotenv, set_key
 from src.security import decrypt_data
 from src.cache import get_cached_response, save_cached_response, get_cached_pr_descriptions
-from src.config import get_api_key, get_api_model, get_skill_dir, resolve_skill_path
+from src.config import get_api_key, get_api_model, get_skill_dir, resolve_skill_path, get_ai_provider, setup_environment
 from src.ai_providers import call_ai_model
 from src.i18n import __, CURRENT_LANG
 from src.updater import __lang_version__
@@ -96,13 +96,20 @@ SMART_EXCLUDES = _load_smart_excludes()
 
 
 def get_doc_url(filename):
-    """Returns the complete URL for a docs/ file, with language suffix if needed."""
-    # e.g.: get_doc_url("untracked-files.md") -> ".../docs/untracked-files.md" (EN) or ".../docs/untracked-files.pt_br.md" (PT)
-    if CURRENT_LANG.startswith("en"):
-        return f"https://github.com/natanfiuza/gitpr/blob/main/docs/{filename}"
-    else:
-        base, ext = filename.rsplit(".", 1)
-        return f"https://github.com/natanfiuza/gitpr/blob/main/docs/{base}.{CURRENT_LANG}.{ext}"
+    """Returns the complete URL for the official GitPR documentation website.
+
+    Transforms a docs/ filename like 'commit-message-ia.md' into a clean website
+    URL with language query parameter. English is the site default (no ?lang=).
+
+    Examples:
+        get_doc_url("untracked-files.md")  -> "https://gitpr.natanfiuza.dev.br/docs/untracked-files"
+        get_doc_url("untracked-files.md")  -> "https://gitpr.natanfiuza.dev.br/docs/untracked-files?lang=pt_br"  (when CURRENT_LANG is pt_br)
+    """
+    base, _ = filename.rsplit(".", 1)
+    url = f"https://gitpr.natanfiuza.dev.br/docs/{base}"
+    if not CURRENT_LANG.startswith("en"):
+        url += f"?lang={CURRENT_LANG}"
+    return url
 
 
 def get_git_diff(quiet=False):
@@ -509,6 +516,82 @@ def install_git_hooks():
 
     return success_count == len(hooks_to_install)
 
+
+def run_install_wizard():
+    """
+    Interactive setup wizard combining --skill, --installhooks, MCP install, and API key check.
+
+    Asks for confirmation before each step and prints a documentation URL at the end.
+    """
+    click.secho(__("\n🔧 Starting GitPR Interactive Setup Wizard..."), fg="cyan", bold=True)
+    click.echo(__("This wizard will guide you through the essential GitPR setup steps.\n"))
+
+    # ------------------------------------------------------------------
+    # Step 1: Skill Templates (equivalent to --skill)
+    # ------------------------------------------------------------------
+    click.secho(__("Step 1 of 4: Skill Templates"), fg="yellow", bold=True)
+    click.echo(__("Downloads template files (.gitpr.*.md, .gitpr.linter.yml) into the .gitpr/skill/ folder."))
+    click.echo(__("These files allow customizing AI behavior for your team's conventions."))
+    if click.confirm(__("Proceed with downloading skill templates?"), default=True):
+        generate_skill_template()
+    else:
+        click.echo(__("Skipped.\n"))
+
+    # ------------------------------------------------------------------
+    # Step 2: Git Hooks (equivalent to --installhooks)
+    # ------------------------------------------------------------------
+    click.secho(__("\nStep 2 of 4: Git Hooks"), fg="yellow", bold=True)
+    click.echo(__("Installs pre-commit (static linter) and prepare-commit-msg (AI commit messages) hooks."))
+    click.echo(__("This enables automatic validation and AI assistance before every commit."))
+    if click.confirm(__("Proceed with installing Git hooks?"), default=True):
+        if install_git_hooks():
+            click.secho(__("✅ Git Hooks successfully installed!"), fg="green", bold=True)
+        else:
+            click.secho(__("⚠️ Some hooks could not be installed."), fg="yellow")
+    else:
+        click.echo(__("Skipped.\n"))
+
+    # ------------------------------------------------------------------
+    # Step 3: MCP Configuration (equivalent to gitpr-mcp --install auto)
+    # ------------------------------------------------------------------
+    click.secho(__("\nStep 3 of 4: MCP Configuration"), fg="yellow", bold=True)
+    click.echo(__("Auto-detects and configures GitPR for VS Code, Cursor, Claude Desktop, and Zed."))
+    click.echo(__("This lets AI-powered editors use GitPR tools directly without the terminal."))
+    if click.confirm(__("Proceed with MCP configuration?"), default=True):
+        # Lazy import to avoid circular dependency at module level
+        from src.mcp_server import _run_install
+        _run_install("auto")
+    else:
+        click.echo(__("Skipped.\n"))
+
+    # ------------------------------------------------------------------
+    # Step 4: API Key Check
+    # ------------------------------------------------------------------
+    click.secho(__("\nStep 4 of 4: API Key Configuration"), fg="yellow", bold=True)
+    provider = get_ai_provider()
+    existing_key = get_api_key(provider)
+    if existing_key:
+        click.secho(
+            __("✅ API key for {provider} is already configured.", provider=provider.capitalize()),
+            fg="green",
+        )
+    else:
+        click.echo(__("No API key found for {provider}.", provider=provider.capitalize()))
+        if click.confirm(__("Would you like to configure it now?"), default=True):
+            setup_environment()
+        else:
+            click.echo(__("You can configure it later by running 'gitpr' or editing ~/.gitpr/.env manually."))
+
+    # ------------------------------------------------------------------
+    # Final: documentation URL
+    # ------------------------------------------------------------------
+    click.echo("")
+    click.secho(__("\n✅ Setup wizard complete!"), fg="green", bold=True)
+    click.echo(__("For more details, see the full documentation:"))
+    click.secho(f"  {get_doc_url('install-wizard.md')}", fg="blue", underline=True)
+    click.echo("")
+
+
 def get_branch_history_text():
     """Compiles the Git Log and PR Cache of the current branch to generate the epic context."""
     branch = get_current_branch()

src/main.py

@@ -14,7 +14,8 @@ from src.core import (
     generate_skill_template,
     install_git_hooks,
     get_branch_history_text,
-    get_doc_url
+    get_doc_url,
+    run_install_wizard,
 )
 from src.linter_engine import parse_diff_and_lint
 from src.i18n import __
@@ -34,7 +35,7 @@ def print_banner():
 """
     click.secho(banner, fg="cyan", bold=True)
     click.secho(__("  🚀 Intelligent PR Automation with AI (v{version})", version=__version__), fg="yellow", bold=True)
-    click.secho(__("  Options: -c,--commit | -r,--review | -f,--fullreview | -l,--linter | -s,--skill | -u,--update | -ih,--installhooks | -is,--issue | -h,--help (use -h --flag for contextual help)\n"), fg="white", dim=True)
+    click.secho(__("  Options: -c,--commit | -r,--review | -f,--fullreview | -l,--linter | -s,--skill | -u,--update | -ih,--installhooks | --install | -is,--issue | -h,--help (use -h --flag for contextual help)\n"), fg="white", dim=True)
 
 
 # ============================================================
@@ -81,6 +82,11 @@ HELP_MAP: dict[str, dict[str, str]] = {
         'title': __('Install Local Git Hooks'),
         'description': __('Installs pre-commit (automatic static linter) and prepare-commit-msg (AI message generation) hooks in the local repository. Adopts the Shift Left practice for pre-push validation.'),
     },
+    'install': {
+        'url': get_doc_url('install-wizard.md'),
+        'title': __('Interactive Setup Wizard (--install)'),
+        'description': __('Guided setup that downloads skill templates, installs Git hooks, configures MCP for your editors, and verifies your AI provider API key.'),
+    },
     'blame': {
         'url': get_doc_url('blame-arqueologo.md'),
         'title': __('Code Archeologist (AI Git Blame)'),
@@ -120,6 +126,7 @@ HELP_PRIORITY: dict[str, int] = {
     'skill': 2,
     'update': 3,
     'installhooks': 4,
+    'install': 14,
     'issue': 5,
     'blame': 6,
     'commit': 7,
@@ -141,6 +148,7 @@ HELP_PRIORITY: dict[str, int] = {
 @click.option('-s', '--skill', is_flag=True, help=__("Downloads the skill template files into the .gitpr/skill/ folder."))
 @click.option('-u', '--update', is_flag=True, help=__("Checks and installs the latest version of GitPR."))
 @click.option('-ih', '--installhooks', is_flag=True, help=__("Automatically installs validation Git Hooks in the project."))
+@click.option('--install', is_flag=True, help=__("Interactive setup wizard: downloads templates, installs hooks, configures MCP, and checks API key."))
 @click.option('--hook', type=click.Path(), hidden=True, help=__("Commit file path (internal hook use)."))
 @click.option('-q', '--quiet', is_flag=True, hidden=True, help=__("Hides banner and non-essential logs (internal use)."))
 @click.option('--pre-save', is_flag=True, hidden=True, help=__("Saves the full AI payload (system + prompt) to a JSON file before each AI call (debug)."))
@@ -151,8 +159,9 @@ HELP_PRIORITY: dict[str, int] = {
 @click.option('-ch', '--chat', is_flag=True, help=__("Opens the interactive Pair Programming chat with AI."))
 @click.option('-p', '--provider', type=click.Choice(['gemini', 'deepseek', 'ollama']), help=__("Forces the use of a specific AI provider for this execution."))
 @click.option('--lang', type=str, help=__("Forces the interface language for this execution (e.g.: en_us, pt_br)."))
+@click.option('--mcp', is_flag=True, hidden=True, help=__("Start the MCP server for integration with VS Code, Cursor, Claude Desktop, etc."))
 @click.option('-h', '--help', 'help_flag', is_flag=True, help=__("Shows this message and exits. Use with another flag for contextual help (e.g., -h --issue)."))
-def cli(commit, review, fullreview, linter, skill, update, installhooks, hook, quiet, pre_save, provider, input, blame, history, issue, chat, help_flag, lang):
+def cli(commit, review, fullreview, linter, skill, update, installhooks, install, hook, quiet, pre_save, provider, input, blame, history, issue, chat, help_flag, lang, mcp):
     """
     GitPR CLI - Intelligent PR Automation and AI Code Review.
 
@@ -221,6 +230,12 @@ def cli(commit, review, fullreview, linter, skill, update, installhooks, hook, q
         set_lang(lang)
         reload_thinking_words(lang)
 
+    # MCP Server Mode — start stdio MCP server (handled before any interactive setup)
+    if mcp:
+        from src.mcp_server import main as mcp_main
+        mcp_main()
+        return
+
     # Silencia o banner se estiver no modo quiet ou via hook
     if not quiet and not hook:
         print_banner()
@@ -287,6 +302,11 @@ def cli(commit, review, fullreview, linter, skill, update, installhooks, hook, q
         check_and_update()
         return
 
+    # --install option: Interactive setup wizard
+    if install:
+        run_install_wizard()
+        return
+
     # --skill option: Generate template and exit
     if skill:
         generate_skill_template()