Skip to content

Fix installation docs and add missing build dependency#41

Open
adalton wants to merge 2 commits intomainfrom
andalton/readme-updates
Open

Fix installation docs and add missing build dependency#41
adalton wants to merge 2 commits intomainfrom
andalton/readme-updates

Conversation

@adalton
Copy link
Copy Markdown
Contributor

@adalton adalton commented Mar 27, 2026

Summary

  • Fixed broken Quick Start: replaced pip install dist/mcp_acp-*.whl (fails after fresh clone since dist/ doesn't exist) with pip install .
  • Fixed Python version: corrected "Python 3.10+" to "Python 3.12+" to match requires-python in pyproject.toml
  • Reorganized Installation section: added "From Source (end users)" as the primary path, clarified "Development Install (contributors)", added comments explaining the make installmake build dependency, and added a "Virtual Environment Install" fallback for PEP 668 systems with MCP client configuration guidance
  • Added missing build dependency: make build runs python -m build but the build package was not in dev dependencies, causing ModuleNotFoundError
  • Fixed stale version: updated hardcoded wheel version from 0.1.0 to 0.3.0 in uvx example

🤖 Generated with Claude Code

The Quick Start referenced a pre-built wheel (dist/mcp_acp-*.whl) that
doesn't exist after a fresh clone, and the Python version requirement
was listed as 3.10+ instead of the actual 3.12+. Reorganized the
Installation section to lead with the simplest path (pip install from
source), clarified audience for each install method, added a venv
fallback for PEP 668 systems with guidance on configuring MCP clients
to use the venv path, and added the missing `build` package to dev
dependencies so `make build` succeeds.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@adalton adalton requested a review from jeremyeder March 27, 2026 20:03
@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Mar 27, 2026

Walkthrough

README installation and development instructions were rewritten (separate end‑user, contributor, and virtualenv flows), Python requirement raised to 3.12+, local wheel reference updated to 0.3.0, build>=1.0.0 added to dev optional dependencies, and package __version__ bumped to 0.3.0.

Changes

Cohort / File(s) Summary
Documentation & Setup
README.md
Rewrote installation/development instructions: Quick Start now clones into mcp/ and uses pip install .; added "From Source (end users)", "Development Install (contributors)" with uv venv and editable install, and "Virtual Environment Install" for PEP 668; documented mcp-acp venv-only usage and full-path client example; updated local wheel example version to 0.3.0; changed Python requirement to 3.12+.
Project Metadata
pyproject.toml
Added build>=1.0.0 to [project.optional-dependencies].dev.
Package Version
src/mcp_acp/__init__.py
Bumped package __version__ from 0.1.0 to 0.3.0.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately summarizes the two main changes: fixing installation documentation and adding the missing build dependency.
Description check ✅ Passed The description provides clear, detailed context for all changes made across the files, including the rationale for each modification.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch andalton/readme-updates

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@adalton adalton self-assigned this Mar 27, 2026
Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@README.md`:
- Line 273: The package version in pyproject.toml (version = "0.3.0") and README
use 0.3.0 but src/mcp_acp/__init__.py still sets __version__ = "0.1.0"; update
the __version__ constant in src/mcp_acp/__init__.py to "0.3.0" so the
module-level __version__ matches pyproject.toml and the README, ensuring
consistent package metadata and runtime version checks.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: cab5c6b2-f63e-462f-8dc2-9f28d364c556

📥 Commits

Reviewing files that changed from the base of the PR and between 95e83ee and 69f0e59.

📒 Files selected for processing (2)
  • README.md
  • pyproject.toml

__init__.py was never updated when 0.3.0 was released in 95e83ee,
leaving __version__ at "0.1.0". Align it with pyproject.toml.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@src/mcp_acp/__init__.py`:
- Line 3: Replace the hardcoded __version__ string in __init__.py with dynamic
retrieval from package metadata: import importlib.metadata (or
importlib_metadata for older Python), attempt to call
importlib.metadata.version("mcp-acp") and assign that to __version__, and fall
back to the existing literal "0.3.0" if the package metadata is not available
(catch PackageNotFoundError or ImportError) so importing the package in a dev
environment still works; update the module-level imports and the __version__
assignment (refer to symbol __version__ in src/mcp_acp/__init__.py and use
importlib.metadata.version as the retrieval function).
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: f1bfed7c-2af8-4d65-b218-b5f514518724

📥 Commits

Reviewing files that changed from the base of the PR and between 69f0e59 and 3ba4e17.

📒 Files selected for processing (1)
  • src/mcp_acp/__init__.py

"""MCP ACP Server - Ambient Code Platform management via MCP."""

__version__ = "0.1.0"
__version__ = "0.3.0"
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick | 🔵 Trivial

LGTM! Version now aligns with pyproject.toml.

The version string correctly matches the version = "0.3.0" declared in pyproject.toml, fixing the previous drift.

Optional: Consider a single source of truth for versioning.

To prevent future version drift between __init__.py and pyproject.toml, consider using importlib.metadata.version("mcp-acp") to read the version dynamically from the installed package metadata, or configure dynamic versioning in pyproject.toml.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@src/mcp_acp/__init__.py` at line 3, Replace the hardcoded __version__ string
in __init__.py with dynamic retrieval from package metadata: import
importlib.metadata (or importlib_metadata for older Python), attempt to call
importlib.metadata.version("mcp-acp") and assign that to __version__, and fall
back to the existing literal "0.3.0" if the package metadata is not available
(catch PackageNotFoundError or ImportError) so importing the package in a dev
environment still works; update the module-level imports and the __version__
assignment (refer to symbol __version__ in src/mcp_acp/__init__.py and use
importlib.metadata.version as the retrieval function).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant