lint docs examples

[samuelcolvin]

Motivation and Context

Many of the examples in th readme were missing imports making them hard to fix.

I've added imports to all examples and also added tests with pytest-examples. (Note: we/I built and maintain pytest-examples).

I presume the fixed imports are relatively uncontroversial, but I welcome feedback on adding pytest-examples.

In other packages we maintain, we also run the examples, e.g. see here which is a lot more work. To get this started, I've avoided running the examples and just linted them with ruff.

How Has This Been Tested?

Yes!

Breaking Changes

NA

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)
• Documentation update

Checklist

• I have read the MCP Documentation
• My code follows the repository's style guidelines
• New and existing tests pass locally
• I have added appropriate error handling
• I have added or updated documentation as needed

Additional context

You should be able to fix linting in examples in future using

uv run pytest tests/test_examples.py --update-examples

[dsp-ant]

This is great! Thank you!

[samuelcolvin]

Best solution long term would be astral-sh/ruff#3792 when it lands.