Thank you for your interest in contributing to the MCP Python SDK! This document provides guidelines and instructions for contributing.
Bug fixes are welcome! For straightforward bugs, feel free to open a PR directly. For complex bugs that require significant changes, consider opening an issue first to discuss the approach.
Please open an issue before starting work on new features or significant enhancements. We will often close pull requests for new features that were not previously discussed. This isn't because we don't appreciate the contribution—it's because adding features creates long-term maintenance burden and requires alignment with the SDK's direction.
What counts as "significant"?
- New public APIs or decorators
- Architectural changes or refactoring
- Changes that touch multiple modules
- Features that might require spec changes (these need a SEP first)
Issues labeled good first issue or help wanted are great places to start. Issues labeled ready for work have been triaged and are ready for implementation.
Issues labeled needs confirmation or needs maintainer action are not good candidates—please wait for maintainer input before starting work on these.
- Make sure you have Python 3.10+ installed
- Install uv
- Fork the repository
- Clone your fork:
git clone https://github.com/YOUR-USERNAME/python-sdk.git - Install dependencies:
uv sync --frozen --all-extras --dev- Set up pre-commit hooks:
uv tool install pre-commit --with pre-commit-uv --force-reinstall-
Choose the correct branch for your changes:
- For bug fixes to a released version: use the latest release branch (e.g. v1.1.x for 1.1.3)
- For new features: use the main branch (which will become the next minor/major version)
- If unsure, ask in an issue first
-
Create a new branch from your chosen base branch
-
Make your changes
-
Ensure tests pass:
uv run pytest- Run type checking:
uv run pyright- Run linting:
uv run ruff check .
uv run ruff format .- Update README snippets if you modified example code:
uv run scripts/update_readme_snippets.py- (Optional) Run pre-commit hooks on all files:
pre-commit run --all-files- Submit a pull request to the same branch you branched from
- We use
rufffor linting and formatting - Follow PEP 8 style guidelines
- Add type hints to all functions
- Include docstrings for public APIs
- Update documentation as needed
- Add tests for new functionality
- Ensure CI passes
- Maintainers will review your code
- Address review feedback
Please note that this project is released with a Code of Conduct. By participating in this project you agree to abide by its terms.
By contributing, you agree that your contributions will be licensed under the MIT License.