From a8b1c5e3aee02a7232c52b054630c3861b3c83cd Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 12 Feb 2026 17:30:43 +0000 Subject: [PATCH 01/10] Add P7-T12: move Cursor IDE uvx settings before installation in README https://claude.ai/code/session_01KZdVptmvNJBYDavZifsJEm --- SPECS/Workplan.md | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/SPECS/Workplan.md b/SPECS/Workplan.md index 61ae971b..16472b51 100644 --- a/SPECS/Workplan.md +++ b/SPECS/Workplan.md @@ -701,10 +701,22 @@ Create a Python-based protocol compatibility wrapper that intercepts MCP respons - **Priority:** P2 - **Dependencies:** P7-T10 - **Parallelizable:** yes -- **Outputs/Artifacts:** +- **Outputs/Artifacts:** - `CHANGELOG.md` with initial 1.0.0 entry - **Acceptance Criteria:** Follows Keep a Changelog format; all phases summarized +#### P7-T12: Move Cursor IDE uvx settings before installation instructions in README +- **Description:** Reorder the README.md so that the Cursor IDE uvx configuration snippet (currently under Configuration > Cursor > "Using uvx (Recommended)") appears before the Installation section. This gives Cursor users the fastest path to getting started — they only need to paste the JSON block into `~/.cursor/mcp.json` and they're done, without scrolling through five installation options first. +- **Priority:** P1 +- **Dependencies:** P7-T10 +- **Parallelizable:** yes +- **Outputs/Artifacts:** + - Updated `README.md` with reordered sections +- **Acceptance Criteria:** + - The Cursor uvx `mcp.json` snippet is visible in the README before the "Installation" heading + - All other README content (installation options, other client configs, usage, etc.) remains intact and in a logical order + - No broken markdown links or formatting issues + --- ### Phase 8: Documentation Publishing From 8cf1a77b09cb1e8f6e0e64dabb8c9a117e69db5f Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 12 Feb 2026 17:35:26 +0000 Subject: [PATCH 02/10] P7-T12: add Web UI options (--web-ui, --web-ui-port) to task scope https://claude.ai/code/session_01KZdVptmvNJBYDavZifsJEm --- SPECS/Workplan.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/SPECS/Workplan.md b/SPECS/Workplan.md index 16472b51..db0fc029 100644 --- a/SPECS/Workplan.md +++ b/SPECS/Workplan.md @@ -706,14 +706,15 @@ Create a Python-based protocol compatibility wrapper that intercepts MCP respons - **Acceptance Criteria:** Follows Keep a Changelog format; all phases summarized #### P7-T12: Move Cursor IDE uvx settings before installation instructions in README -- **Description:** Reorder the README.md so that the Cursor IDE uvx configuration snippet (currently under Configuration > Cursor > "Using uvx (Recommended)") appears before the Installation section. This gives Cursor users the fastest path to getting started — they only need to paste the JSON block into `~/.cursor/mcp.json` and they're done, without scrolling through five installation options first. +- **Description:** Reorder the README.md so that the Cursor IDE uvx configuration snippet (currently under Configuration > Cursor > "Using uvx (Recommended)") appears before the Installation section. This gives Cursor users the fastest path to getting started — they only need to paste the JSON block into `~/.cursor/mcp.json` and they're done, without scrolling through five installation options first. Include both the basic uvx snippet and the uvx-with-Web-UI variant (`--web-ui`, `--web-ui-port 8080`) so users can choose either option up front. - **Priority:** P1 - **Dependencies:** P7-T10 - **Parallelizable:** yes - **Outputs/Artifacts:** - Updated `README.md` with reordered sections - **Acceptance Criteria:** - - The Cursor uvx `mcp.json` snippet is visible in the README before the "Installation" heading + - The Cursor uvx `mcp.json` snippet (basic) is visible in the README before the "Installation" heading + - The Cursor uvx-with-Web-UI `mcp.json` snippet (`--web-ui`, `--web-ui-port 8080`) is also shown alongside the basic snippet - All other README content (installation options, other client configs, usage, etc.) remains intact and in a logical order - No broken markdown links or formatting issues From 7c5d705aeb36ef4120aee1a469fd8d1716e99a3d Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 12 Feb 2026 17:37:20 +0000 Subject: [PATCH 03/10] Select task P7-T12: Move Cursor IDE uvx settings before installation instructions in README https://claude.ai/code/session_01KZdVptmvNJBYDavZifsJEm --- SPECS/INPROGRESS/next.md | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-) diff --git a/SPECS/INPROGRESS/next.md b/SPECS/INPROGRESS/next.md index f0801a09..44d4332e 100644 --- a/SPECS/INPROGRESS/next.md +++ b/SPECS/INPROGRESS/next.md @@ -1,14 +1,15 @@ -# No Active Task +# Next Task: P7-T12 — Move Cursor IDE uvx settings before installation instructions in README -The previously selected task has been archived. +**Priority:** P1 +**Phase:** Phase 7: Documentation +**Effort:** 1 hour +**Dependencies:** P7-T10 +**Status:** Selected -## Recently Archived +## Description -- 2026-02-12 — FU-REBUILD-P10-T1-6: Fix uninstall.sh package detection/removal asymmetry and venv cleanup (PASS) -- 2026-02-11 — FU-REBUILD-P10-T1-5: Validate and fix documentation paths for local-running MCP server with Web UI (PASS) -- 2026-02-11 — P10-T3: Recover main branch after accidental Web UI merge (PASS) +Reorder the README.md so that the Cursor IDE uvx configuration snippet (currently under Configuration > Cursor > "Using uvx (Recommended)") appears before the Installation section. Include both the basic uvx snippet and the uvx-with-Web-UI variant (`--web-ui`, `--web-ui-port 8080`) so users can choose either option up front. -## Suggested Next Tasks +## Next Step -- FU-P8-T1-1: Reconcile P8-T1 URL criteria with current GitHub Pages path and resolve DocC reference warnings (P2) -- Run SELECT after adding new tasks to the workplan. +Run the PLAN command to generate the implementation-ready PRD. From 26f7d539b7b44d46d09d6fcd57b8a87851ee6bef Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 12 Feb 2026 17:37:57 +0000 Subject: [PATCH 04/10] Plan task P7-T12: Move Cursor IDE uvx settings before installation instructions in README https://claude.ai/code/session_01KZdVptmvNJBYDavZifsJEm --- ...T12_Move_Cursor_UVX_Before_Installation.md | 42 +++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 SPECS/INPROGRESS/P7-T12_Move_Cursor_UVX_Before_Installation.md diff --git a/SPECS/INPROGRESS/P7-T12_Move_Cursor_UVX_Before_Installation.md b/SPECS/INPROGRESS/P7-T12_Move_Cursor_UVX_Before_Installation.md new file mode 100644 index 00000000..9b22a702 --- /dev/null +++ b/SPECS/INPROGRESS/P7-T12_Move_Cursor_UVX_Before_Installation.md @@ -0,0 +1,42 @@ +# P7-T12 — Move Cursor IDE uvx Settings Before Installation Instructions in README + +**Priority:** P1 +**Phase:** Phase 7: Documentation +**Dependencies:** P7-T10 + +## Objective + +Reorder README.md so the Cursor IDE uvx configuration (basic and Web UI variants) appears before the Installation section. Cursor is the primary target client, and most users only need to paste a JSON block into `~/.cursor/mcp.json` — they shouldn't have to scroll through five installation options first. + +## Success Criteria + +1. The Cursor uvx basic `mcp.json` snippet is visible in the README before the "### Installation" heading. +2. The Cursor uvx-with-Web-UI `mcp.json` snippet (`--web-ui`, `--web-ui-port 8080`) is shown alongside the basic snippet. +3. All other README content (installation options, other client configs, usage, etc.) remains intact and in a logical order. +4. No broken markdown links, formatting issues, or content loss. +5. The Configuration > Cursor section no longer duplicates the uvx snippets that were moved up (but retains manual / venv options). + +## Plan + +### Phase A: Extract and Relocate + +1. **Create a new section** between "Quick Start > Prerequisites / Python Environment" and "### Installation" titled something like "### Cursor Quick Setup (Recommended)" or similar. +2. **Move** the two Cursor uvx snippets (basic + Web UI) into this new section, with brief instructions to paste into `~/.cursor/mcp.json`. +3. **Remove** the "Using uvx (Recommended)" and "Using uvx with Web UI" entries from the Configuration > Cursor subsection to avoid duplication. +4. **Add a note** in Configuration > Cursor referencing the Quick Setup section above for uvx users. + +### Phase B: Validate + +1. Review the entire README top-to-bottom for logical flow. +2. Check that no markdown anchors or cross-references are broken. +3. Run quality gates (pytest, ruff, mypy) to ensure no code was accidentally affected. + +## Affected Files + +- `README.md` — section reorder + +## Notes + +- No code changes required; documentation-only task. +- Other client configurations (Claude Code, Codex CLI, Zed, Kimi) stay in the Configuration section unchanged. +- The full Cursor subsection (manual install, venv options) remains in Configuration for users who need it. From 2c31f937f996aba326d49eb91c0a90139e4168a2 Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 12 Feb 2026 17:40:01 +0000 Subject: [PATCH 05/10] Implement P7-T12: move Cursor uvx settings before Installation in README Add a "Cursor Quick Setup" section with basic and Web UI uvx snippets between Prerequisites and Installation. Replace duplicated uvx entries in Configuration > Cursor with a cross-reference link. https://claude.ai/code/session_01KZdVptmvNJBYDavZifsJEm --- README.md | 71 +++++++++++--------- SPECS/INPROGRESS/P7-T12_Validation_Report.md | 38 +++++++++++ 2 files changed, 76 insertions(+), 33 deletions(-) create mode 100644 SPECS/INPROGRESS/P7-T12_Validation_Report.md diff --git a/README.md b/README.md index 7a4d886b..04ab3973 100644 --- a/README.md +++ b/README.md @@ -63,6 +63,43 @@ Both should point to `.venv/bin/...` while the environment is active. > > If you see "Found 0 tools" in your MCP client logs, this setting is not enabled. +### Cursor Quick Setup + +If you use **Cursor**, no installation is needed — just add this to `~/.cursor/mcp.json`: + +```json +{ + "mcpServers": { + "xcode-tools": { + "command": "uvx", + "args": ["--from", "mcpbridge-wrapper", "mcpbridge-wrapper"] + } + } +} +``` + +With Web UI dashboard (optional — adds real-time monitoring at http://localhost:8080): + +```json +{ + "mcpServers": { + "xcode-tools": { + "command": "uvx", + "args": [ + "--from", + "mcpbridge-wrapper", + "mcpbridge-wrapper", + "--web-ui", + "--web-ui-port", + "8080" + ] + } + } +} +``` + +Restart Cursor and you're done. For other clients or installation methods, read on. + ### Installation #### Option 1: Using uvx (Recommended - Easiest) @@ -147,39 +184,7 @@ Options: #### Cursor -**Using uvx (Recommended):** - -Edit `~/.cursor/mcp.json`: - -```json -{ - "mcpServers": { - "xcode-tools": { - "command": "uvx", - "args": ["--from", "mcpbridge-wrapper", "mcpbridge-wrapper"] - } - } -} -``` - -**Using uvx with Web UI (Optional):** -```json -{ - "mcpServers": { - "xcode-tools": { - "command": "uvx", - "args": [ - "--from", - "mcpbridge-wrapper", - "mcpbridge-wrapper", - "--web-ui", - "--web-ui-port", - "8080" - ] - } - } -} -``` +For **uvx** setup (recommended), see [Cursor Quick Setup](#cursor-quick-setup) above. **Using manual installation:** diff --git a/SPECS/INPROGRESS/P7-T12_Validation_Report.md b/SPECS/INPROGRESS/P7-T12_Validation_Report.md new file mode 100644 index 00000000..a590bf5b --- /dev/null +++ b/SPECS/INPROGRESS/P7-T12_Validation_Report.md @@ -0,0 +1,38 @@ +# P7-T12 Validation Report + +**Task:** Move Cursor IDE uvx settings before installation instructions in README +**Date:** 2026-02-12 +**Verdict:** PASS + +## Changes Made + +1. **Added new "Cursor Quick Setup" section** (lines 66-101) between Prerequisites and Installation in README.md. Contains: + - Basic uvx `mcp.json` snippet + - uvx-with-Web-UI `mcp.json` snippet (`--web-ui`, `--web-ui-port 8080`) + - Brief intro text and "restart Cursor" CTA + +2. **Replaced duplicated uvx entries** in Configuration > Cursor with a cross-reference link: `For **uvx** setup (recommended), see [Cursor Quick Setup](#cursor-quick-setup) above.` + +3. **Preserved** all manual installation, venv, and Web UI options in the Configuration > Cursor subsection. + +## Acceptance Criteria Verification + +| Criterion | Status | +|-----------|--------| +| Cursor uvx basic snippet visible before "### Installation" heading | PASS — lines 70-78 | +| Cursor uvx-with-Web-UI snippet shown alongside basic snippet | PASS — lines 83-98 | +| All other README content intact and in logical order | PASS — no content removed, order preserved | +| No broken markdown links or formatting issues | PASS — verified top-to-bottom | +| No duplicate uvx snippets in Configuration > Cursor | PASS — replaced with cross-reference | + +## Quality Gate Results + +| Gate | Result | +|------|--------| +| pytest | 296 passed, 9 skipped | +| ruff check src/ | All checks passed | +| mypy src/ | Success: no issues found in 12 source files | + +## Files Modified + +- `README.md` — section reorder (documentation-only change) From a4769e538ab8d85b870a29f66f7c3200a76b4b7c Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 12 Feb 2026 17:41:42 +0000 Subject: [PATCH 06/10] Archive task P7-T12: Move_Cursor_UVX_Before_Installation (PASS) https://claude.ai/code/session_01KZdVptmvNJBYDavZifsJEm --- SPECS/ARCHIVE/INDEX.md | 2 ++ ...T12_Move_Cursor_UVX_Before_Installation.md | 4 ++++ .../P7-T12_Validation_Report.md | 0 SPECS/INPROGRESS/next.md | 19 +++++++++---------- SPECS/Workplan.md | 2 +- 5 files changed, 16 insertions(+), 11 deletions(-) rename SPECS/{INPROGRESS => ARCHIVE/P7-T12_Move_Cursor_UVX_Before_Installation}/P7-T12_Move_Cursor_UVX_Before_Installation.md (97%) rename SPECS/{INPROGRESS => ARCHIVE/P7-T12_Move_Cursor_UVX_Before_Installation}/P7-T12_Validation_Report.md (100%) diff --git a/SPECS/ARCHIVE/INDEX.md b/SPECS/ARCHIVE/INDEX.md index b2a6eed2..d2d6ff6c 100644 --- a/SPECS/ARCHIVE/INDEX.md +++ b/SPECS/ARCHIVE/INDEX.md @@ -73,6 +73,7 @@ | P10-T3 | [P10-T3_Recover_Main_Branch_After_Accidental_Web_UI_Merge/](P10-T3_Recover_Main_Branch_After_Accidental_Web_UI_Merge/) | 2026-02-11 | PASS | | FU-REBUILD-P10-T1-5 | [FU-REBUILD-P10-T1-5_Validate_Documentation_Paths/](FU-REBUILD-P10-T1-5_Validate_Documentation_Paths/) | 2026-02-11 | PASS | | FU-REBUILD-P10-T1-6 | [FU-REBUILD-P10-T1-6_Fix_Uninstall_Asymmetry/](FU-REBUILD-P10-T1-6_Fix_Uninstall_Asymmetry/) | 2026-02-12 | PASS | +| P7-T12 | [P7-T12_Move_Cursor_UVX_Before_Installation/](P7-T12_Move_Cursor_UVX_Before_Installation/) | 2026-02-12 | PASS | ## Historical Artifacts @@ -174,3 +175,4 @@ | 2026-02-12 | P8-T1 | Archived REVIEW_P8-T1_Current_Branch_Validation report | | 2026-02-12 | FU-REBUILD-P10-T1-6 | Archived Fix_Uninstall_Asymmetry (PASS) | | 2026-02-12 | FU-REBUILD-P10-T1-6 | Archived REVIEW_FU-REBUILD-P10-T1-6_Uninstall_Asymmetry report | +| 2026-02-12 | P7-T12 | Archived Move_Cursor_UVX_Before_Installation (PASS) | diff --git a/SPECS/INPROGRESS/P7-T12_Move_Cursor_UVX_Before_Installation.md b/SPECS/ARCHIVE/P7-T12_Move_Cursor_UVX_Before_Installation/P7-T12_Move_Cursor_UVX_Before_Installation.md similarity index 97% rename from SPECS/INPROGRESS/P7-T12_Move_Cursor_UVX_Before_Installation.md rename to SPECS/ARCHIVE/P7-T12_Move_Cursor_UVX_Before_Installation/P7-T12_Move_Cursor_UVX_Before_Installation.md index 9b22a702..9e56adab 100644 --- a/SPECS/INPROGRESS/P7-T12_Move_Cursor_UVX_Before_Installation.md +++ b/SPECS/ARCHIVE/P7-T12_Move_Cursor_UVX_Before_Installation/P7-T12_Move_Cursor_UVX_Before_Installation.md @@ -40,3 +40,7 @@ Reorder README.md so the Cursor IDE uvx configuration (basic and Web UI variants - No code changes required; documentation-only task. - Other client configurations (Claude Code, Codex CLI, Zed, Kimi) stay in the Configuration section unchanged. - The full Cursor subsection (manual install, venv options) remains in Configuration for users who need it. + +--- +**Archived:** 2026-02-12 +**Verdict:** PASS diff --git a/SPECS/INPROGRESS/P7-T12_Validation_Report.md b/SPECS/ARCHIVE/P7-T12_Move_Cursor_UVX_Before_Installation/P7-T12_Validation_Report.md similarity index 100% rename from SPECS/INPROGRESS/P7-T12_Validation_Report.md rename to SPECS/ARCHIVE/P7-T12_Move_Cursor_UVX_Before_Installation/P7-T12_Validation_Report.md diff --git a/SPECS/INPROGRESS/next.md b/SPECS/INPROGRESS/next.md index 44d4332e..5d9e26ca 100644 --- a/SPECS/INPROGRESS/next.md +++ b/SPECS/INPROGRESS/next.md @@ -1,15 +1,14 @@ -# Next Task: P7-T12 — Move Cursor IDE uvx settings before installation instructions in README +# No Active Task -**Priority:** P1 -**Phase:** Phase 7: Documentation -**Effort:** 1 hour -**Dependencies:** P7-T10 -**Status:** Selected +The previously selected task has been archived. -## Description +## Recently Archived -Reorder the README.md so that the Cursor IDE uvx configuration snippet (currently under Configuration > Cursor > "Using uvx (Recommended)") appears before the Installation section. Include both the basic uvx snippet and the uvx-with-Web-UI variant (`--web-ui`, `--web-ui-port 8080`) so users can choose either option up front. +- 2026-02-12 — P7-T12: Move Cursor IDE uvx settings before installation instructions in README (PASS) +- 2026-02-12 — FU-REBUILD-P10-T1-6: Fix uninstall.sh package detection/removal asymmetry and venv cleanup (PASS) +- 2026-02-11 — FU-REBUILD-P10-T1-5: Validate and fix documentation paths for local-running MCP server with Web UI (PASS) -## Next Step +## Suggested Next Tasks -Run the PLAN command to generate the implementation-ready PRD. +- FU-P8-T1-1: Reconcile P8-T1 URL criteria with current GitHub Pages path and resolve DocC reference warnings (P2) +- Run SELECT after adding new tasks to the workplan. diff --git a/SPECS/Workplan.md b/SPECS/Workplan.md index db0fc029..f54d188b 100644 --- a/SPECS/Workplan.md +++ b/SPECS/Workplan.md @@ -705,7 +705,7 @@ Create a Python-based protocol compatibility wrapper that intercepts MCP respons - `CHANGELOG.md` with initial 1.0.0 entry - **Acceptance Criteria:** Follows Keep a Changelog format; all phases summarized -#### P7-T12: Move Cursor IDE uvx settings before installation instructions in README +#### ✅ P7-T12: Move Cursor IDE uvx settings before installation instructions in README - **Description:** Reorder the README.md so that the Cursor IDE uvx configuration snippet (currently under Configuration > Cursor > "Using uvx (Recommended)") appears before the Installation section. This gives Cursor users the fastest path to getting started — they only need to paste the JSON block into `~/.cursor/mcp.json` and they're done, without scrolling through five installation options first. Include both the basic uvx snippet and the uvx-with-Web-UI variant (`--web-ui`, `--web-ui-port 8080`) so users can choose either option up front. - **Priority:** P1 - **Dependencies:** P7-T10 From 3d0a3b31ebf246557091d8ac97119b487da58982 Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 12 Feb 2026 17:42:29 +0000 Subject: [PATCH 07/10] =?UTF-8?q?Review=20P7-T12:=20Cursor=20Quick=20Setup?= =?UTF-8?q?=20=E2=80=94=20approve,=20no=20issues?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit https://claude.ai/code/session_01KZdVptmvNJBYDavZifsJEm --- .../REVIEW_P7-T12_Cursor_Quick_Setup.md | 26 +++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 SPECS/INPROGRESS/REVIEW_P7-T12_Cursor_Quick_Setup.md diff --git a/SPECS/INPROGRESS/REVIEW_P7-T12_Cursor_Quick_Setup.md b/SPECS/INPROGRESS/REVIEW_P7-T12_Cursor_Quick_Setup.md new file mode 100644 index 00000000..19eb4897 --- /dev/null +++ b/SPECS/INPROGRESS/REVIEW_P7-T12_Cursor_Quick_Setup.md @@ -0,0 +1,26 @@ +## REVIEW REPORT — P7-T12 Cursor Quick Setup + +**Scope:** 6 commits on `claude/reorder-readme-sections-eEEGI` +**Files:** 1 code file (README.md), plus workflow artifacts (Workplan, next.md, PRD, validation report, INDEX.md) + +### Summary Verdict +- [x] Approve + +### Critical Issues +None. + +### Secondary Issues +None. + +### Architectural Notes +- The new "Cursor Quick Setup" section sits at the ideal position: after prerequisites (so the user knows about Xcode MCP toggle) but before the five installation options. This mirrors the common "TL;DR" pattern in popular open-source README files. +- Cross-reference link `[Cursor Quick Setup](#cursor-quick-setup)` in Configuration > Cursor avoids content duplication while keeping the Configuration section navigable for manual/venv users. +- No code changes; documentation-only, so no risk of regression. + +### Tests +- All 296 tests pass (9 skipped, as before). +- Coverage unaffected (documentation-only change). +- ruff and mypy clean. + +### Next Steps +- No follow-up tasks required. The change is self-contained and complete. From defd900a757846d9010d24d0ef8eedc073736df0 Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 12 Feb 2026 17:43:08 +0000 Subject: [PATCH 08/10] Archive REVIEW_P7-T12_Cursor_Quick_Setup report https://claude.ai/code/session_01KZdVptmvNJBYDavZifsJEm --- SPECS/ARCHIVE/INDEX.md | 2 ++ .../REVIEW_P7-T12_Cursor_Quick_Setup.md | 0 2 files changed, 2 insertions(+) rename SPECS/{INPROGRESS => ARCHIVE/P7-T12_Move_Cursor_UVX_Before_Installation}/REVIEW_P7-T12_Cursor_Quick_Setup.md (100%) diff --git a/SPECS/ARCHIVE/INDEX.md b/SPECS/ARCHIVE/INDEX.md index d2d6ff6c..66e39761 100644 --- a/SPECS/ARCHIVE/INDEX.md +++ b/SPECS/ARCHIVE/INDEX.md @@ -111,6 +111,7 @@ | [FOLLOWUP_P10-T3_Main_Branch_Recovery.md](P10-T3_Recover_Main_Branch_After_Accidental_Web_UI_Merge/FOLLOWUP_P10-T3_Main_Branch_Recovery.md) | Follow-up report for P10-T3 | | [REVIEW_FU-REBUILD-P10-T1-5_Documentation_Paths.md](FU-REBUILD-P10-T1-5_Validate_Documentation_Paths/REVIEW_FU-REBUILD-P10-T1-5_Documentation_Paths.md) | Review report for FU-REBUILD-P10-T1-5 | | [REVIEW_FU-REBUILD-P10-T1-6_Uninstall_Asymmetry.md](FU-REBUILD-P10-T1-6_Fix_Uninstall_Asymmetry/REVIEW_FU-REBUILD-P10-T1-6_Uninstall_Asymmetry.md) | Review report for FU-REBUILD-P10-T1-6 | +| [REVIEW_P7-T12_Cursor_Quick_Setup.md](P7-T12_Move_Cursor_UVX_Before_Installation/REVIEW_P7-T12_Cursor_Quick_Setup.md) | Review report for P7-T12 | ## Archive Log @@ -176,3 +177,4 @@ | 2026-02-12 | FU-REBUILD-P10-T1-6 | Archived Fix_Uninstall_Asymmetry (PASS) | | 2026-02-12 | FU-REBUILD-P10-T1-6 | Archived REVIEW_FU-REBUILD-P10-T1-6_Uninstall_Asymmetry report | | 2026-02-12 | P7-T12 | Archived Move_Cursor_UVX_Before_Installation (PASS) | +| 2026-02-12 | P7-T12 | Archived REVIEW_P7-T12_Cursor_Quick_Setup report | diff --git a/SPECS/INPROGRESS/REVIEW_P7-T12_Cursor_Quick_Setup.md b/SPECS/ARCHIVE/P7-T12_Move_Cursor_UVX_Before_Installation/REVIEW_P7-T12_Cursor_Quick_Setup.md similarity index 100% rename from SPECS/INPROGRESS/REVIEW_P7-T12_Cursor_Quick_Setup.md rename to SPECS/ARCHIVE/P7-T12_Move_Cursor_UVX_Before_Installation/REVIEW_P7-T12_Cursor_Quick_Setup.md From 023800d2072b3263dda6cf8685a50059cadd2886 Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 12 Feb 2026 18:04:29 +0000 Subject: [PATCH 09/10] Move Python Environment Setup section below Cursor Quick Setup MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cursor users need zero Python setup — they just paste the JSON snippet. Development-only venv instructions now follow the quick-start path. https://claude.ai/code/session_01KZdVptmvNJBYDavZifsJEm --- README.md | 46 +++++++++++++++++++++++----------------------- 1 file changed, 23 insertions(+), 23 deletions(-) diff --git a/README.md b/README.md index 04ab3973..6126bc54 100644 --- a/README.md +++ b/README.md @@ -35,32 +35,11 @@ Xcode's `mcpbridge` returns tool responses in the `content` field but omits the - Python 3.7+ - **Xcode Tools MCP Server enabled** (see below) -### Python Environment Setup (Development) - -If you plan to run `make install`, `pytest`, or other development commands, create and activate a virtual environment first. This avoids Homebrew Python's `externally-managed-environment` (PEP 668) error. - -```bash -cd XcodeMCPWrapper -python3 -m venv .venv -source .venv/bin/activate -python3 -m pip install --upgrade pip -make install -``` - -Quick checks: - -```bash -which python3 -which pip -``` - -Both should point to `.venv/bin/...` while the environment is active. - > ⚠️ **Important:** You MUST enable Xcode Tools MCP in Xcode settings: > 1. Open **Xcode** > **Settings** (⌘,) -> 2. Select **Intelligence** in the sidebar +> 2. Select **Intelligence** in the sidebar > 3. Under **Model Context Protocol**, toggle **Xcode Tools** ON -> +> > If you see "Found 0 tools" in your MCP client logs, this setting is not enabled. ### Cursor Quick Setup @@ -100,6 +79,27 @@ With Web UI dashboard (optional — adds real-time monitoring at http://localhos Restart Cursor and you're done. For other clients or installation methods, read on. +### Python Environment Setup (Development) + +If you plan to run `make install`, `pytest`, or other development commands, create and activate a virtual environment first. This avoids Homebrew Python's `externally-managed-environment` (PEP 668) error. + +```bash +cd XcodeMCPWrapper +python3 -m venv .venv +source .venv/bin/activate +python3 -m pip install --upgrade pip +make install +``` + +Quick checks: + +```bash +which python3 +which pip +``` + +Both should point to `.venv/bin/...` while the environment is active. + ### Installation #### Option 1: Using uvx (Recommended - Easiest) From 62e73bb9a946f8459c6e4a8b5085ff3b4a83d133 Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 12 Feb 2026 18:06:21 +0000 Subject: [PATCH 10/10] Sync DocC XcodeMCPWrapper.md with README section reorder Mirror the Cursor Quick Setup and Python Environment Setup changes so the doccheck-branch CI gate passes. https://claude.ai/code/session_01KZdVptmvNJBYDavZifsJEm --- .../Documentation.docc/XcodeMCPWrapper.md | 50 ++++++++++++++----- 1 file changed, 38 insertions(+), 12 deletions(-) diff --git a/Sources/XcodeMCPWrapper/Documentation.docc/XcodeMCPWrapper.md b/Sources/XcodeMCPWrapper/Documentation.docc/XcodeMCPWrapper.md index d6e79a96..4a9fbfa4 100644 --- a/Sources/XcodeMCPWrapper/Documentation.docc/XcodeMCPWrapper.md +++ b/Sources/XcodeMCPWrapper/Documentation.docc/XcodeMCPWrapper.md @@ -31,6 +31,43 @@ This wrapper intercepts responses from `xcrun mcpbridge` and copies the data fro ## Quick Start +### Cursor Quick Setup + +If you use **Cursor**, no installation is needed — just add this to `~/.cursor/mcp.json`: + +```json +{ + "mcpServers": { + "xcode-tools": { + "command": "uvx", + "args": ["--from", "mcpbridge-wrapper", "mcpbridge-wrapper"] + } + } +} +``` + +With Web UI dashboard (optional — adds real-time monitoring at http://localhost:8080): + +```json +{ + "mcpServers": { + "xcode-tools": { + "command": "uvx", + "args": [ + "--from", + "mcpbridge-wrapper", + "mcpbridge-wrapper", + "--web-ui", + "--web-ui-port", + "8080" + ] + } + } +} +``` + +Restart Cursor and you're done. For other clients or installation methods, read on. + ### Python Environment Setup (Development) If you plan to run development commands such as `make install`, `make test`, or editable installs, create and activate a virtual environment first. This avoids Homebrew Python's `externally-managed-environment` (PEP 668) error. @@ -93,18 +130,7 @@ To remove xcodemcpwrapper from your system: #### Cursor -**Using uvx (Recommended):** - -```json -{ - "mcpServers": { - "xcode-tools": { - "command": "uvx", - "args": ["--from", "mcpbridge-wrapper", "mcpbridge-wrapper"] - } - } -} -``` +For **uvx** setup (recommended), see **Cursor Quick Setup** above. **Using manual installation:**