fastmcp 2.11.1__tar.gz → 2.11.3__tar.gz

{fastmcp-2.11.1 → fastmcp-2.11.3}/.github/ISSUE_TEMPLATE/bug.yml

@@ -5,12 +5,12 @@ labels: [bug, pending]
 body:
   - type: markdown
     attributes:
-      value: Thank you for contributing to FastMCP! 🙏
+      value: Thanks for contributing to FastMCP! 🙏
 
   - type: markdown
     attributes:
       value: |
-        ## Before you submit 📝
+        ### Before you submit
 
         To help us help you, please:
 
@@ -18,7 +18,7 @@ body:
         - 🔍 **Check if someone else has already reported this issue** or if it's been fixed on the main branch
         - 📋 **You MUST include a copy/pasteable and properly formatted MRE** (minimal reproducible example) below or your issue may be closed without response
 
-        Thanks for helping make FastMCP better! 🚀
+        Thanks for helping to make FastMCP better! 🚀
 
   - type: textarea
     id: description
@@ -38,17 +38,20 @@ body:
       description: >
         If applicable, please provide a self-contained,
         [minimal, reproducible example](https://stackoverflow.com/help/minimal-reproducible-example)
-        demonstrating the bug.
-
-        If possible, your example should be a single-file script. Instead of `.run()`-ing an MCP server, use a `Client` to directly interact with it (`async with Client(mcp) as client: ...`) and demonstrate the issue.
+        demonstrating the bug. If possible, your example should be a single-file script.
 
       placeholder: |
+        import asyncio
         from fastmcp import FastMCP, Client
 
         mcp = FastMCP()
 
-        async with Client(mcp) as client:
-            ...
+        async def demo():
+            async with Client(mcp) as client:
+                ... # show the bug here
+
+        if __name__ == "__main__":
+            asyncio.run(demo())
       render: Python
 
   - type: textarea
@@ -56,28 +59,13 @@ body:
     attributes:
       label: Version Information
       description: |
-        Please provide information about your FastMCP version, MCP version, Python version, and OS.
+        Please tell us about your FastMCP version, MCP version, Python version, and OS, as well as any other relevant details about your environment.
 
-        To get this information, run the following command in your terminal and paste the output below:
+        To get the basic information, run the following command in your terminal and paste the output below:
 
         ```bash
         fastmcp version --copy
         ```
-
-        *Note: if you're using FastMCP < 2.10.3, run `fastmcp version` instead.*
-
-        If there is other information that would be helpful, please include it as well.
       render: Text
     validations:
       required: true
-
-  - type: textarea
-    id: additional_context
-    attributes:
-      label: Additional Context
-      description: |
-        Add any other context about the problem here. This could include:
-        - The full error message and traceback (if applicable)
-        - Information about your environment (e.g., virtual environment, installed packages)
-        - Steps to reproduce the issue
-        - Any recent changes in your code or setup that might be relevant

fastmcp-2.11.3/.github/ISSUE_TEMPLATE/enhancement.yml

@@ -0,0 +1,34 @@
+name: 💡 Enhancement Request
+description: Suggest an idea or improvement for FastMCP
+labels: [enhancement, pending]
+
+body:
+  - type: markdown
+    attributes:
+      value: Thanks for contributing to FastMCP! 🙏
+
+  - type: markdown
+    attributes:
+      value: |
+        ### Before you submit
+
+        To help us evaluate your enhancement request:
+
+        - 🔍 **Check if this has already been requested** - search existing issues first
+        - 💭 **Think about the broader impact** - how would this affect other users?
+        - 📋 **Consider implementation complexity** - is this a small change or a major feature?
+
+        Thanks for helping to make FastMCP better! 🚀
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Enhancement
+      description: |
+        Please describe the enhancement:
+
+        - What problem or use case would it solve?
+        - How would it improve your workflow or experience with FastMCP?
+        - Are there any alternative solutions you've considered?
+    validations:
+      required: true

fastmcp-2.11.3/.github/copilot-instructions.md

@@ -0,0 +1 @@
+../AGENTS.md

fastmcp-2.11.3/.github/workflows/marvin.yml

@@ -0,0 +1,52 @@
+name: Marvin Context Protocol
+
+on:
+  issue_comment: { types: [created] }
+  pull_request_review_comment: { types: [created] }
+  pull_request_review: { types: [submitted] }
+  issues: { types: [opened, edited, assigned, labeled] }
+  discussion: { types: [created, edited, labeled] }
+  discussion_comment: { types: [created] }
+
+permissions:
+  contents: write
+  issues: write
+  pull-requests: write
+  discussions: write
+  actions: read
+  id-token: write
+
+jobs:
+  marvin:
+    if: |
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '/marvin')) ||
+      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '/marvin')) ||
+      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '/marvin')) ||
+      (github.event_name == 'issues' && contains(github.event.issue.body, '/marvin')) ||
+      (github.event_name == 'discussion' && contains(github.event.discussion.body, '/marvin')) ||
+      (github.event_name == 'discussion_comment' && contains(github.event.comment.body, '/marvin')) ||
+      (github.event_name == 'issues' && github.event.action == 'assigned' && github.event.assignee.login == 'Marvin Context Protocol') ||
+      (github.event_name == 'issues' && github.event.action == 'labeled' && github.event.label.name == 'marvin')
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Generate Marvin App token
+        id: marvin-token
+        uses: actions/create-github-app-token@v1
+        with:
+          app-id: ${{ secrets.MARVIN_APP_ID }}
+          private-key: ${{ secrets.MARVIN_APP_PRIVATE_KEY }}
+
+      # Marvin Assistant
+      - name: Marvin
+        uses: anthropics/claude-code-action@beta
+        with:
+          github_token: ${{ steps.marvin-token.outputs.token }}
+          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
+          mode: tag
+          trigger_phrase: "/marvin"
+          allowed_bots: "*"
+          allowed_tools: "mcp__github__add_issue_comment,mcp__github__create_issue,mcp__github__get_issue,mcp__github__list_issues,mcp__github__search_issues,mcp__github__update_issue,mcp__github__update_issue_comment,mcp__github__create_pull_request,mcp__github__get_pull_request,mcp__github__get_pull_request_comments,mcp__github__get_pull_request_files,mcp__github__get_pull_request_reviews,mcp__github__get_pull_request_status,mcp__github__list_pull_requests,mcp__github__update_pull_request,mcp__github__update_pull_request_branch,mcp__github__update_pull_request_comment,mcp__github__merge_pull_request"
+          additional_permissions: |
+            actions: read

{fastmcp-2.11.1 → fastmcp-2.11.3}/.github/workflows/run-static.yml

@@ -42,7 +42,29 @@ jobs:
           python-version: "3.12"
       - name: Install dependencies
         run: uv sync --dev
+      - name: Install just
+        uses: extractions/setup-just@v3
+      - name: Check lockfile is up to date
+        run: |
+          if ! uv lock --check; then
+            echo "❌ Lockfile is out of date!"
+            echo "To update the lockfile, run 'uv lock'."
+            exit 1
+          fi
+          echo "✅ Lockfile is up to date"
       - name: Run pre-commit
         uses: pre-commit/action@v3.0.1
         env:
           SKIP: no-commit-to-branch
+      - name: Check SDK documentation is up to date
+        run: |
+          just api-ref-all > /dev/null 2>&1
+          if ! git diff --quiet docs/python-sdk/ docs/docs.json; then
+            echo "❌ SDK documentation is out of date!"
+            echo "Files that were updated:"
+            git diff --name-only docs/python-sdk/ docs/docs.json
+            echo ""
+            echo "Run 'just api-ref-all' and commit the changes."
+            exit 1
+          fi
+          echo "✅ SDK documentation is up to date"

{fastmcp-2.11.1 → fastmcp-2.11.3}/.github/workflows/run-tests.yml

@@ -44,7 +44,8 @@ jobs:
           python-version: ${{ matrix.python-version }}
 
       - name: Install FastMCP
-        run: uv sync --locked
+        # run with frozen to use the current lockfile; static checks will determine if it needs updating
+        run: uv sync --frozen
 
       - name: Run tests (excluding integration and client_process)
         run: uv run pytest tests -m "not integration and not client_process"
@@ -68,7 +69,8 @@ jobs:
           python-version: "3.10"
 
       - name: Install FastMCP
-        run: uv sync --locked
+        # run with frozen to use the current lockfile; static checks will determine if it needs updating
+        run: uv sync --frozen
 
       - name: Run integration tests
         run: uv run pytest tests -m "integration"

{fastmcp-2.11.1 → fastmcp-2.11.3}/.gitignore

@@ -63,3 +63,8 @@ dmypy.json
 
 # Claude worktree management
 .claude-wt/worktrees
+
+# Common FastMCP test files
+/test.py
+/server.py
+/client.py

fastmcp-2.11.3/AGENTS.md

@@ -0,0 +1,134 @@
+# FastMCP Development Guidelines
+
+> **Audience**: LLM-driven engineering agents and human developers
+
+FastMCP is a comprehensive Python framework (Python ≥3.10) for building Model Context Protocol (MCP) servers and clients. This is the actively maintained v2.0 providing a complete toolkit for the MCP ecosystem.
+
+## Required Development Workflow
+
+**CRITICAL**: Always run these commands in sequence before committing:
+
+```bash
+uv sync                              # Install dependencies
+uv run pre-commit run --all-files    # Ruff + Prettier + Pyright
+uv run pytest                        # Run full test suite
+```
+
+**All three must pass** - this is enforced by CI. Alternative: `just build && just typecheck && just test`
+
+**Tests must pass and lint/typing must be clean before committing.**
+
+## Repository Structure
+
+| Path             | Purpose                                                |
+| ---------------- | ------------------------------------------------------ |
+| `src/fastmcp/`   | Library source code (Python ≥ 3.10)                   |
+| `  ├─server/`    | Server implementation, `FastMCP`, auth, networking    |
+| `  │  ├─auth/`   | Authentication providers (Bearer, JWT, WorkOS)        |
+| `  │  └─middleware/` | Error handling, logging, rate limiting             |
+| `  ├─client/`    | High-level client SDK + transports                    |
+| `  │  └─auth/`   | Client authentication (Bearer, OAuth)                 |
+| `  ├─tools/`     | Tool implementations + `ToolManager`                  |
+| `  ├─resources/` | Resources, templates + `ResourceManager`              |
+| `  ├─prompts/`   | Prompt templates + `PromptManager`                     |
+| `  ├─cli/`       | FastMCP CLI commands (`run`, `dev`, `install`)         |
+| `  ├─contrib/`   | Community contributions (bulk caller, mixins)         |
+| `  ├─experimental/` | Experimental features (new OpenAPI parser)         |
+| `  └─utilities/` | Shared utilities (logging, JSON schema, HTTP)         |
+| `tests/`         | Comprehensive pytest suite with markers               |
+| `docs/`          | Mintlify documentation (published to gofastmcp.com)   |
+| `examples/`      | Runnable demo servers (echo, smart_home, atproto)     |
+
+## Core MCP Objects
+
+When modifying MCP functionality, changes typically need to be applied across all object types:
+- **Tools** (`src/tools/` + `ToolManager`)
+- **Resources** (`src/resources/` + `ResourceManager`)
+- **Resource Templates** (`src/resources/` + `ResourceManager`)
+- **Prompts** (`src/prompts/` + `PromptManager`)
+
+## Testing Best Practices
+
+### Always Use In-Memory Transport
+
+Pass FastMCP servers directly to clients for testing:
+
+```python
+mcp = FastMCP("TestServer")
+
+@mcp.tool
+def greet(name: str) -> str:
+    return f"Hello, {name}!"
+
+# Direct connection - no network complexity
+async with Client(mcp) as client:
+    result = await client.call_tool("greet", {"name": "World"})
+```
+
+Only use HTTP transport when explicitly testing network features:
+```python
+# Network testing only
+async with Client(transport=StreamableHttpTransport(server_url)) as client:
+    result = await client.ping()
+```
+
+## Development Rules
+
+### Git & CI
+- Pre-commit hooks are required (run automatically on commits)
+- Never amend commits to fix pre-commit failures
+- Apply PR labels: bugs/breaking/enhancements/features
+- Improvements = enhancements (not features) unless specified
+
+### Commit Messages and Agent Attribution
+- **NEVER** include agent attribution in commit messages or PR titles/descriptions (no "🤖 Generated with [tool]", "with Claude", etc.)
+- Agent attribution is ONLY allowed in Co-authored-by lines in commits
+- Keep commit messages brief - ideally just headlines, not detailed messages
+- Focus on what changed, not how or why
+
+### Code Standards
+- Python ≥ 3.10 with full type annotations
+- Follow existing patterns and maintain consistency
+- Use `# type: ignore[attr-defined]` in tests for MCP results instead of type assertions
+- Each feature needs corresponding tests
+
+### Documentation
+- Uses Mintlify framework
+- Files must be in docs.json to be included
+- Never modify `docs/python-sdk/**` (auto-generated)
+
+## Key Tools & Commands
+
+### Environment Setup
+```bash
+git clone <repo>
+cd fastmcp
+uv sync                    # Installs all deps including dev tools
+```
+
+### Validation Commands (Run Frequently)
+- **Linting**: `uv run ruff check` (or with `--fix`)
+- **Type Checking**: `uv run pyright`
+- **All Checks**: `uv run pre-commit run --all-files`
+
+### Testing
+- **Standard**: `uv run pytest`
+- **Integration**: `uv run pytest -m "integration"`
+- **Excluding markers**: `uv run pytest -m "not integration and not client_process"`
+
+### CLI Usage
+- **Run server**: `uv run fastmcp run server.py`
+- **Development**: `uv run fastmcp dev server.py` (with Inspector UI)
+- **Help**: `uv run fastmcp --help`
+
+## Critical Patterns
+
+### Error Handling
+- Never use bare `except` - be specific with exception types
+- Use `# type: ignore[attr-defined]` in tests for MCP results
+
+### Build Issues (Common Solutions)
+1. **Dependencies**: Always `uv sync` first
+2. **Pre-commit fails**: Run `uv run pre-commit run --all-files` to see failures
+3. **Type errors**: Use `uv run pyright` directly, check `pyproject.toml` config
+4. **Test timeouts**: Default 3s - optimize or mark as integration tests

fastmcp-2.11.3/CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md

{fastmcp-2.11.1 → fastmcp-2.11.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastmcp
-Version: 2.11.1
+Version: 2.11.3
 Summary: The fast, Pythonic way to build MCP servers and clients.
 Project-URL: Homepage, https://gofastmcp.com
 Project-URL: Repository, https://github.com/jlowin/fastmcp
@@ -21,7 +21,7 @@ Requires-Dist: authlib>=1.5.2
 Requires-Dist: cyclopts>=3.0.0
 Requires-Dist: exceptiongroup>=1.2.2
 Requires-Dist: httpx>=0.28.1
-Requires-Dist: mcp>=1.10.0
+Requires-Dist: mcp<2.0.0,>=1.12.4
 Requires-Dist: openapi-core>=0.19.5
 Requires-Dist: openapi-pydantic>=0.5.1
 Requires-Dist: pydantic[email]>=2.11.7

{fastmcp-2.11.1 → fastmcp-2.11.3}/docs/clients/logging.mdx

@@ -100,12 +100,12 @@ async def detailed_log_handler(message: LogMessage):
 
 ## Default Log Handling
 
-If you don't provide a custom `log_handler`, FastMCP uses a default handler that emits a DEBUG-level FastMCP log for every log message received from the server, which is useful for visibility without polluting your own logs.
+If you don't provide a custom `log_handler`, FastMCP's default handler routes server logs to the appropriate Python logging levels. The MCP levels are mapped as follows: `notice` → INFO; `alert` and `emergency` → CRITICAL. If the server includes a logger name, it is prefixed in the message, and any `extra` data is forwarded via the logging `extra` parameter.
 
 ```python
 client = Client("my_mcp_server.py")
 
 async with client:
-    # Server logs will be emitted at DEBUG level automatically
+    # Server logs are forwarded at their proper severity (DEBUG/INFO/WARNING/ERROR/CRITICAL)
     await client.call_tool("some_tool")
 ```

{fastmcp-2.11.1 → fastmcp-2.11.3}/docs/docs.json

@@ -65,7 +65,10 @@
                   {
                     "group": "Essentials",
                     "icon": "cube",
-                    "pages": ["servers/server", "deployment/running-server"]
+                    "pages": [
+                      "servers/server",
+                      "deployment/running-server"
+                    ]
                   },
                   {
                     "group": "Core Components",
@@ -108,7 +111,10 @@
                   {
                     "group": "Essentials",
                     "icon": "cube",
-                    "pages": ["clients/client", "clients/transports"]
+                    "pages": [
+                      "clients/client",
+                      "clients/transports"
+                    ]
                   },
                   {
                     "group": "Core Operations",
@@ -134,7 +140,10 @@
                   {
                     "group": "Authentication",
                     "icon": "user-shield",
-                    "pages": ["clients/auth/oauth", "clients/auth/bearer"]
+                    "pages": [
+                      "clients/auth/oauth",
+                      "clients/auth/bearer"
+                    ]
                   }
                 ]
               },
@@ -162,7 +171,6 @@
                 "pages": [
                   "patterns/tool-transformation",
                   "patterns/decorating-methods",
-                  "patterns/http-requests",
                   "patterns/testing",
                   "patterns/cli",
                   "patterns/contrib"
@@ -181,12 +189,17 @@
           },
           {
             "anchor": "What's New",
-            "pages": ["updates", "changelog"]
+            "pages": [
+              "updates",
+              "changelog"
+            ]
           },
           {
             "anchor": "Community",
             "icon": "users",
-            "pages": ["community/showcase"]
+            "pages": [
+              "community/showcase"
+            ]
           }
         ]
       },