Merge branch 'main' into main

Author: SoldierSacha

.git-blame-ignore-revs

@@ -0,0 +1,2 @@
+# Applied 120 line-length rule to all files: https://github.com/modelcontextprotocol/python-sdk/pull/856
+543961968c0634e93d919d509cce23a1d6a56c21

.github/ISSUE_TEMPLATE/bug.yaml

@@ -0,0 +1,55 @@
+name: 🐛 MCP Python SDK Bug
+description: Report a bug or unexpected behavior in the MCP Python SDK
+labels: ["need confirmation"]
+
+body:
+  - type: markdown
+    attributes:
+      value: Thank you for contributing to the MCP Python SDK! ✊
+
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Initial Checks
+      description: Just making sure you're using the latest version of MCP Python SDK.
+      options:
+        - label: I confirm that I'm using the latest version of MCP Python SDK
+          required: true
+        - label: I confirm that I searched for my issue in https://github.com/modelcontextprotocol/python-sdk/issues before opening this issue
+          required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: |
+        Please explain what you're seeing and what you would expect to see.
+
+        Please provide as much detail as possible to make understanding and solving your problem as quick as possible. 🙏
+    validations:
+      required: true
+
+  - type: textarea
+    id: example
+    attributes:
+      label: Example Code
+      description: >
+        If applicable, please add a self-contained,
+        [minimal, reproducible, example](https://stackoverflow.com/help/minimal-reproducible-example)
+        demonstrating the bug.
+
+      placeholder: |
+        from mcp.server.fastmcp import FastMCP
+
+        ...
+      render: Python
+
+  - type: textarea
+    id: version
+    attributes:
+      label: Python & MCP Python SDK
+      description: |
+        Which version of Python and MCP Python SDK are you using?
+      render: Text
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1 @@
+blank_issues_enabled: true

.github/ISSUE_TEMPLATE/config.yaml

@@ -0,0 +1,29 @@
+name: 🚀 MCP Python SDK Feature Request
+description: "Suggest a new feature for the MCP Python SDK"
+labels: ["feature request"]
+
+body:
+  - type: markdown
+    attributes:
+      value: Thank you for contributing to the MCP Python SDK! ✊
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: |
+        Please give as much detail as possible about the feature you would like to suggest. 🙏
+
+        You might like to add:
+        * A demo of how code might look when using the feature
+        * Your use case(s) for the feature
+        * Reference to other projects that have a similar feature
+    validations:
+      required: true
+
+  - type: textarea
+    id: references
+    attributes:
+      label: References
+      description: |
+        Please add any links or references that might help us understand your feature request better. 📚

.github/ISSUE_TEMPLATE/feature-request.yaml

@@ -0,0 +1,33 @@
+name: ❓ MCP Python SDK Question
+description: "Ask a question about the MCP Python SDK"
+labels: ["question"]
+
+body:
+  - type: markdown
+    attributes:
+      value: Thank you for reaching out to the MCP Python SDK community! We're here to help! 🤝
+
+  - type: textarea
+    id: question
+    attributes:
+      label: Question
+      description: |
+        Please provide as much detail as possible about your question. 🙏
+
+        You might like to include:
+        * Code snippets showing what you've tried
+        * Error messages you're encountering (if any)
+        * Expected vs actual behavior
+        * Your use case and what you're trying to achieve
+    validations:
+      required: true
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional Context
+      description: |
+        Please provide any additional context that might help us better understand your question, such as:
+        * Your MCP Python SDK version
+        * Your Python version
+        * Relevant configuration or environment details 📝

.github/ISSUE_TEMPLATE/feature_request.md

@@ -4,42 +4,28 @@ on:
   workflow_call:
 
 jobs:
-  format:
+  pre-commit:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
 
-      - name: Install uv
-        uses: astral-sh/setup-uv@v3
+      - uses: astral-sh/setup-uv@v5
         with:
           enable-cache: true
           version: 0.7.2
 
-      - name: Install the project
-        run: uv sync --frozen --all-extras --dev --python 3.12
-
-      - name: Run ruff format check
-        run: uv run --no-sync ruff check .
-
-  typecheck:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
+      - name: Install dependencies
+        run: uv sync --frozen --all-extras --python 3.10
 
-      - name: Install uv
-        uses: astral-sh/setup-uv@v3
+      - uses: pre-commit/[email protected]
         with:
-          enable-cache: true
-          version: 0.7.2
-
-      - name: Install the project
-        run: uv sync --frozen --all-extras --dev --python 3.12
-
-      - name: Run pyright
-        run: uv run --no-sync pyright
+          extra_args: --all-files --verbose
+        env:
+          SKIP: no-commit-to-branch
 
   test:
     runs-on: ${{ matrix.os }}
+    timeout-minutes: 10
     strategy:
       matrix:
         python-version: ["3.10", "3.11", "3.12", "3.13"]
@@ -55,7 +41,7 @@ jobs:
           version: 0.7.2
 
       - name: Install the project
-        run: uv sync --frozen --all-extras --dev --python ${{ matrix.python-version }}
+        run: uv sync --frozen --all-extras --python ${{ matrix.python-version }}
 
       - name: Run pytest
         run: uv run --no-sync pytest

.github/ISSUE_TEMPLATE/question.yaml

@@ -47,18 +47,14 @@
 
 DB_DSN = "postgresql://postgres:postgres@localhost:54320/memory_db"
 # reset memory with rm ~/.fastmcp/{USER}/memory/*
-PROFILE_DIR = (
-    Path.home() / ".fastmcp" / os.environ.get("USER", "anon") / "memory"
-).resolve()
+PROFILE_DIR = (Path.home() / ".fastmcp" / os.environ.get("USER", "anon") / "memory").resolve()
 PROFILE_DIR.mkdir(parents=True, exist_ok=True)
 
 
 def cosine_similarity(a: list[float], b: list[float]) -> float:
     a_array = np.array(a, dtype=np.float64)
     b_array = np.array(b, dtype=np.float64)
-    return np.dot(a_array, b_array) / (
-        np.linalg.norm(a_array) * np.linalg.norm(b_array)
-    )
+    return np.dot(a_array, b_array) / (np.linalg.norm(a_array) * np.linalg.norm(b_array))
 
 
 async def do_ai[T](
@@ -97,9 +93,7 @@ class MemoryNode(BaseModel):
     summary: str = ""
     importance: float = 1.0
     access_count: int = 0
-    timestamp: float = Field(
-        default_factory=lambda: datetime.now(timezone.utc).timestamp()
-    )
+    timestamp: float = Field(default_factory=lambda: datetime.now(timezone.utc).timestamp())
     embedding: list[float]
 
     @classmethod
@@ -152,9 +146,7 @@ async def merge_with(self, other: Self, deps: Deps):
         self.importance += other.importance
         self.access_count += other.access_count
         self.embedding = [(a + b) / 2 for a, b in zip(self.embedding, other.embedding)]
-        self.summary = await do_ai(
-            self.content, "Summarize the following text concisely.", str, deps
-        )
+        self.summary = await do_ai(self.content, "Summarize the following text concisely.", str, deps)
         await self.save(deps)
         # Delete the merged node from the database
         if other.id is not None:
@@ -221,9 +213,7 @@ async def find_similar_memories(embedding: list[float], deps: Deps) -> list[Memo
 
 async def update_importance(user_embedding: list[float], deps: Deps):
     async with deps.pool.acquire() as conn:
-        rows = await conn.fetch(
-            "SELECT id, importance, access_count, embedding FROM memories"
-        )
+        rows = await conn.fetch("SELECT id, importance, access_count, embedding FROM memories")
         for row in rows:
             memory_embedding = row["embedding"]
             similarity = cosine_similarity(user_embedding, memory_embedding)
@@ -273,25 +263,19 @@ async def display_memory_tree(deps: Deps) -> str:
         )
     result = ""
     for row in rows:
-        effective_importance = row["importance"] * (
-            1 + math.log(row["access_count"] + 1)
-        )
+        effective_importance = row["importance"] * (1 + math.log(row["access_count"] + 1))
         summary = row["summary"] or row["content"]
         result += f"- {summary} (Importance: {effective_importance:.2f})\n"
     return result
 
 
 @mcp.tool()
 async def remember(
-    contents: list[str] = Field(
-        description="List of observations or memories to store"
-    ),
+    contents: list[str] = Field(description="List of observations or memories to store"),
 ):
     deps = Deps(openai=AsyncOpenAI(), pool=await get_db_pool())
     try:
-        return "\n".join(
-            await asyncio.gather(*[add_memory(content, deps) for content in contents])
-        )
+        return "\n".join(await asyncio.gather(*[add_memory(content, deps) for content in contents]))
     finally:
         await deps.pool.close()
 
@@ -305,9 +289,7 @@ async def read_profile() -> str:
 
 
 async def initialize_database():
-    pool = await asyncpg.create_pool(
-        "postgresql://postgres:postgres@localhost:54320/postgres"
-    )
+    pool = await asyncpg.create_pool("postgresql://postgres:postgres@localhost:54320/postgres")
     try:
         async with pool.acquire() as conn:
             await conn.execute("""

.github/workflows/check-lock.yml

@@ -28,15 +28,11 @@
 
 
 class SurgeSettings(BaseSettings):
-    model_config: SettingsConfigDict = SettingsConfigDict(
-        env_prefix="SURGE_", env_file=".env"
-    )
+    model_config: SettingsConfigDict = SettingsConfigDict(env_prefix="SURGE_", env_file=".env")
 
     api_key: str
     account_id: str
-    my_phone_number: Annotated[
-        str, BeforeValidator(lambda v: "+" + v if not v.startswith("+") else v)
-    ]
+    my_phone_number: Annotated[str, BeforeValidator(lambda v: "+" + v if not v.startswith("+") else v)]
     my_first_name: str
     my_last_name: str
 

.github/workflows/shared.yml

@@ -8,10 +8,7 @@
 mcp = FastMCP()
 
 
-@mcp.tool(
-    description="🌟 A tool that uses various Unicode characters in its description: "
-    "á é í ó ú ñ 漢字 🎉"
-)
+@mcp.tool(description="🌟 A tool that uses various Unicode characters in its description: " "á é í ó ú ñ 漢字 🎉")
 def hello_unicode(name: str = "世界", greeting: str = "¡Hola") -> str:
     """
     A simple tool that demonstrates Unicode handling in: