aiohttp-tiny-mcp 0.3.0__tar.gz → 0.3.2__tar.gz

{aiohttp_tiny_mcp-0.3.0 → aiohttp_tiny_mcp-0.3.2}/LICENSE

@@ -1,3 +1,4 @@
+
                                  Apache License
                            Version 2.0, January 2004
                         http://www.apache.org/licenses/
@@ -86,21 +87,22 @@
       granted to You under this License for that Work shall terminate
       as of the date such litigation is filed.
 
-   4. Redistribution. You may reproduce and distribute copies of the Work
-      or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You meet
-      the following conditions:
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
 
-      (a) You must give any other recipients of the Work or Derivative Works
-          a copy of this License; and
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
 
       (b) You must cause any modified files to carry prominent notices
           stating that You changed the files; and
 
-      (c) You must retain, in the Source form of any Derivative Works that
-          You distribute, all copyright, patent, trademark, and attribution
-          notices from the Source form of the Work, excluding those notices
-          that do not pertain to any part of the Derivative Works; and
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
 
       (d) If the Work includes a "NOTICE" text file as part of its
           distribution, then any Derivative Works that You distribute must
@@ -130,11 +132,14 @@
       any Contribution intentionally submitted for inclusion in the Work
       by You to the Licensor shall be under the terms and conditions of
       this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
 
    6. Trademarks. This License does not grant permission to use the trade
       names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing
-      the origin of the Work and reproducing the content of the NOTICE file.
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
 
    7. Disclaimer of Warranty. Unless required by applicable law or
       agreed to in writing, Licensor provides the Work (and each
@@ -152,11 +157,11 @@
       negligent acts) or agreed to in writing, shall any Contributor be
       liable to You for damages, including any direct, indirect, special,
       incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the Work
-      (including but not limited to damages for loss of goodwill, work
-      stoppage, computer failure or malfunction, or any and all other
-      commercial damages or losses), even if such Contributor has been
-      advised of the possibility of such damages.
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
 
    9. Accepting Warranty or Additional Liability. While redistributing
       the Work or Derivative Works thereof, You may choose to offer,
@@ -170,3 +175,28 @@
       of your accepting any such warranty or additional liability.
 
    END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

{aiohttp_tiny_mcp-0.3.0 → aiohttp_tiny_mcp-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aiohttp-tiny-mcp
-Version: 0.3.0
+Version: 0.3.2
 Summary: Remote MCP server and client library for aiohttp
 License-Expression: Apache-2.0
 License-File: LICENSE
@@ -28,6 +28,7 @@ Requires-Dist: aiohttp>=3.14
 Requires-Dist: pydantic>=2.13
 Requires-Dist: psycopg[binary,pool]>=3 ; extra == 'postgres'
 Requires-Dist: redis>=5 ; extra == 'redis'
+Requires-Dist: pyyaml>=6 ; extra == 'skills'
 Requires-Dist: aiosqlite>=0.20 ; extra == 'sqlite'
 Requires-Python: >=3.10
 Project-URL: Documentation, https://mosquito.github.io/aiohttp-tiny-mcp/
@@ -35,12 +36,14 @@ Project-URL: Repository, https://github.com/mosquito/aiohttp-tiny-mcp
 Project-URL: Issues, https://github.com/mosquito/aiohttp-tiny-mcp/issues
 Provides-Extra: postgres
 Provides-Extra: redis
+Provides-Extra: skills
 Provides-Extra: sqlite
 Description-Content-Type: text/markdown
 
 # aiohttp-tiny-mcp
 
 [![Tests](https://github.com/mosquito/aiohttp-tiny-mcp/actions/workflows/tests.yml/badge.svg)](https://github.com/mosquito/aiohttp-tiny-mcp/actions/workflows/tests.yml)
+[![Coverage](https://img.shields.io/coveralls/github/mosquito/aiohttp-tiny-mcp/master)](https://coveralls.io/github/mosquito/aiohttp-tiny-mcp?branch=master)
 [![Latest release](https://img.shields.io/github/v/release/mosquito/aiohttp-tiny-mcp)](https://github.com/mosquito/aiohttp-tiny-mcp/releases)
 [![License](https://img.shields.io/github/license/mosquito/aiohttp-tiny-mcp)](https://github.com/mosquito/aiohttp-tiny-mcp/blob/master/LICENSE)
 [![Documentation](https://img.shields.io/badge/docs-online-blue.svg)](https://mosquito.github.io/aiohttp-tiny-mcp/)
@@ -230,6 +233,7 @@ Start with [the documentation overview](https://mosquito.github.io/aiohttp-tiny-
 4. [Using Exchange](https://mosquito.github.io/aiohttp-tiny-mcp/guide/exchange.html): request context, progress, questions, and state.
 5. [Authentication](https://mosquito.github.io/aiohttp-tiny-mcp/guide/auth.html): bearer-token verification and OAuth resource metadata.
 6. [Stores and hubs](https://mosquito.github.io/aiohttp-tiny-mcp/deployment/stores.html): shared backend contracts and deployment requirements.
+7. [Extensions and skills](https://mosquito.github.io/aiohttp-tiny-mcp/guide/extensions.html): custom methods, skill directories, and resources for older clients.
 
 The server supports `2026-07-28`, `2025-11-25`, `2025-06-18`, `2025-03-26`
 and `2024-11-05`.
@@ -240,6 +244,7 @@ Delivery mechanisms and client support differ; see the
 Documentation examples are checked by the test suite. From a source checkout:
 
 ```bash
+uv sync --all-groups --all-extras
 uv run pytest docs README.md
-uv run --group docs sphinx-build -W -b html docs docs/_build
+uv run sphinx-build -W -b html docs docs/_build
 ```

{aiohttp_tiny_mcp-0.3.0 → aiohttp_tiny_mcp-0.3.2}/README.md

@@ -1,6 +1,7 @@
 # aiohttp-tiny-mcp
 
 [![Tests](https://github.com/mosquito/aiohttp-tiny-mcp/actions/workflows/tests.yml/badge.svg)](https://github.com/mosquito/aiohttp-tiny-mcp/actions/workflows/tests.yml)
+[![Coverage](https://img.shields.io/coveralls/github/mosquito/aiohttp-tiny-mcp/master)](https://coveralls.io/github/mosquito/aiohttp-tiny-mcp?branch=master)
 [![Latest release](https://img.shields.io/github/v/release/mosquito/aiohttp-tiny-mcp)](https://github.com/mosquito/aiohttp-tiny-mcp/releases)
 [![License](https://img.shields.io/github/license/mosquito/aiohttp-tiny-mcp)](https://github.com/mosquito/aiohttp-tiny-mcp/blob/master/LICENSE)
 [![Documentation](https://img.shields.io/badge/docs-online-blue.svg)](https://mosquito.github.io/aiohttp-tiny-mcp/)
@@ -190,6 +191,7 @@ Start with [the documentation overview](https://mosquito.github.io/aiohttp-tiny-
 4. [Using Exchange](https://mosquito.github.io/aiohttp-tiny-mcp/guide/exchange.html): request context, progress, questions, and state.
 5. [Authentication](https://mosquito.github.io/aiohttp-tiny-mcp/guide/auth.html): bearer-token verification and OAuth resource metadata.
 6. [Stores and hubs](https://mosquito.github.io/aiohttp-tiny-mcp/deployment/stores.html): shared backend contracts and deployment requirements.
+7. [Extensions and skills](https://mosquito.github.io/aiohttp-tiny-mcp/guide/extensions.html): custom methods, skill directories, and resources for older clients.
 
 The server supports `2026-07-28`, `2025-11-25`, `2025-06-18`, `2025-03-26`
 and `2024-11-05`.
@@ -200,6 +202,7 @@ Delivery mechanisms and client support differ; see the
 Documentation examples are checked by the test suite. From a source checkout:
 
 ```bash
+uv sync --all-groups --all-extras
 uv run pytest docs README.md
-uv run --group docs sphinx-build -W -b html docs docs/_build
+uv run sphinx-build -W -b html docs docs/_build
 ```

{aiohttp_tiny_mcp-0.3.0 → aiohttp_tiny_mcp-0.3.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "aiohttp-tiny-mcp"
-version = "0.3.0"
+version = "0.3.2"
 description = "Remote MCP server and client library for aiohttp"
 readme = "README.md"
 license = "Apache-2.0"
@@ -39,12 +39,14 @@ Repository = "https://github.com/mosquito/aiohttp-tiny-mcp"
 Issues = "https://github.com/mosquito/aiohttp-tiny-mcp/issues"
 
 [project.optional-dependencies]
+skills = ["PyYAML>=6"]
 sqlite = ["aiosqlite>=0.20"]
 redis = ["redis>=5"]
 postgres = ["psycopg[binary,pool]>=3"]
 
 [dependency-groups]
 dev = [
+    "PyYAML>=6",
     "PyJWT>=2.13",
     "aiosqlite>=0.20",
     "furo>=2025.12.19",
@@ -54,6 +56,7 @@ dev = [
     "psycopg[binary,pool]>=3",
     "pytest",
     "pytest-asyncio",
+    "pytest-cov>=7.1.0",
     "pytest-timeout",
     "redis>=5",
     "ruff",
@@ -69,6 +72,14 @@ source-include = [
     "src/aiohttp_tiny_mcp/console/*.js",
 ]
 
+[tool.coverage.run]
+source = ["aiohttp_tiny_mcp"]
+branch = true
+
+[tool.coverage.report]
+skip_covered = true
+show_missing = true
+
 [tool.pytest.ini_options]
 asyncio_mode = "auto"
 timeout = 30
@@ -102,5 +113,5 @@ root = [
 exclude = ["examples/docker-mcp"]
 
 [build-system]
-requires = ["uv_build>=0.11.32,<0.12"]
+requires = ["uv_build>=0.12,<0.13"]
 build-backend = "uv_build"

{aiohttp_tiny_mcp-0.3.0 → aiohttp_tiny_mcp-0.3.2}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "aiohttp-tiny-mcp"
-version = "0.3.0"
+version = "0.3.2"
 description = "Remote MCP server and client library for aiohttp"
 readme = "README.md"
 license = "Apache-2.0"
@@ -39,6 +39,7 @@ Repository = "https://github.com/mosquito/aiohttp-tiny-mcp"
 Issues = "https://github.com/mosquito/aiohttp-tiny-mcp/issues"
 
 [project.optional-dependencies]
+skills = ["PyYAML>=6"]
 # A hub and a session store on one SQLite file: aiohttp_tiny_mcp.sqlite.
 sqlite = ["aiosqlite>=0.20"]
 redis = [
@@ -50,6 +51,7 @@ postgres = [
 
 [dependency-groups]
 dev = [
+    "PyYAML>=6",
     "PyJWT>=2.13",
     "aiosqlite>=0.20",
     "furo>=2025.12.19",
@@ -59,6 +61,7 @@ dev = [
     "psycopg[binary,pool]>=3",
     "pytest",
     "pytest-asyncio",
+    "pytest-cov>=7.1.0",
     "pytest-timeout",
     "redis>=5",
     "ruff",
@@ -72,9 +75,17 @@ dev = [
 source-include = ["src/aiohttp_tiny_mcp/console/*.html", "src/aiohttp_tiny_mcp/console/*.css", "src/aiohttp_tiny_mcp/console/*.js"]
 
 [build-system]
-requires = ["uv_build>=0.11.32,<0.12"]
+requires = ["uv_build>=0.12,<0.13"]
 build-backend = "uv_build"
 
+[tool.coverage.run]
+source = ["aiohttp_tiny_mcp"]
+branch = true
+
+[tool.coverage.report]
+skip_covered = true
+show_missing = true
+
 [tool.pytest.ini_options]
 asyncio_mode = "auto"
 # The guard against a hung test, not a measure of how fast the machine is. A

{aiohttp_tiny_mcp-0.3.0 → aiohttp_tiny_mcp-0.3.2}/src/aiohttp_tiny_mcp/__init__.py

@@ -15,6 +15,7 @@ from .core import (
 )
 from .endpoint import Endpoint
 from .exchange import Exchange
+from .extensions import Extension
 from .http_sse import SseEndpoint
 from .hub import Hub, MemoryHub
 from .models import (
@@ -55,6 +56,7 @@ __all__ = [
     "Endpoint",
     "SSEResponse",
     "Exchange",
+    "Extension",
     "GetPromptResult",
     "Hint",
     "Hub",

{aiohttp_tiny_mcp-0.3.0 → aiohttp_tiny_mcp-0.3.2}/src/aiohttp_tiny_mcp/adapter.py

@@ -26,6 +26,7 @@ from .core import (
     answer_actions,
     decode_failure_target,
 )
+from .extensions import ExtensionSpec
 from .hub import Hub
 from .models import (
     CallToolParams,
@@ -72,6 +73,8 @@ class RegistryProtocol(Protocol):
     def prompts(self) -> Mapping[str, PromptSpec]: ...
     @property
     def completer(self) -> Bound | None: ...
+    @property
+    def extensions(self) -> Mapping[str, ExtensionSpec]: ...
     def match_resource(self, uri: str) -> tuple[ResourceSpec, dict[str, str]] | None: ...
 
 
@@ -113,7 +116,9 @@ class Adapter(ABC):
         """Raise `Rejected` on a revision-specific HTTP binding violation."""
         return None  # noqa: B027 -- concrete default, most revisions check nothing
 
-    def decode(self, pre: Preamble) -> Sequence[Call | DecodeFailure]:
+    def decode(
+        self, pre: Preamble, registry: RegistryProtocol | None = None
+    ) -> Sequence[Call | DecodeFailure]:
         """Decode messages independently; one invalid item does not abort the batch."""
         if pre.parse_error:
             raise Rejected(Failure(FailureKind.PARSE, "invalid JSON body"))
@@ -122,10 +127,12 @@ class Adapter(ABC):
                 raise Rejected(Failure(FailureKind.MALFORMED, "batching not supported"))
             if not pre.body:  # `is_batch` already means the body is a list
                 raise Rejected(Failure(FailureKind.MALFORMED, "empty batch"))
-            return [self.decode_item(item) for item in pre.body]
-        return [self.decode_item(pre.body)]
+            return [self.decode_item(item, registry) for item in pre.body]
+        return [self.decode_item(pre.body, registry)]
 
-    def decode_item(self, item: object) -> Call | DecodeFailure:
+    def decode_item(
+        self, item: object, registry: RegistryProtocol | None = None
+    ) -> Call | DecodeFailure:
         """Preserve the request id on failure without aborting sibling batch items."""
         if not isinstance(item, dict):
             return DecodeFailure(
@@ -135,12 +142,12 @@ class Adapter(ABC):
             )
         body = cast(dict[str, Any], item)
         try:
-            return self.decode_one(body)
+            return self.decode_one(body, registry)
         except Rejected as e:
             call_id, must_respond = decode_failure_target(body)
             return DecodeFailure(id=call_id, failure=e.failure, must_respond=must_respond)
 
-    def decode_one(self, body: dict[str, Any]) -> Call:
+    def decode_one(self, body: dict[str, Any], registry: RegistryProtocol | None = None) -> Call:
         if "id" in body and body["id"] is None:
             raise Rejected(Failure(FailureKind.MALFORMED, "id must not be null"))
         try:
@@ -148,6 +155,12 @@ class Adapter(ABC):
         except ValidationError as e:
             raise Rejected(Failure(FailureKind.MALFORMED, str(e))) from None
         operation = self.operation_for(msg.method)
+        if operation is None and registry is not None and self.supports_extensions:
+            if any(
+                msg.method in spec.methods and spec.min_revision <= self.version
+                for spec in registry.extensions.values()
+            ):
+                operation = Operation.EXTENSION
         if operation is None:
             raise Rejected(Failure(FailureKind.UNKNOWN_METHOD, f"unknown method: {msg.method}"))
         self.check_message(operation, msg)
@@ -156,7 +169,17 @@ class Adapter(ABC):
         except ValidationError as e:
             raise Rejected(Failure(FailureKind.INVALID_PARAMS, str(e))) from None
         self.check_params(params)
-        return self.build_call(operation, msg, params)
+        call = self.build_call(operation, msg, params)
+        if operation is Operation.EXTENSION:
+            if msg.is_notification:
+                raise Rejected(Failure(FailureKind.MALFORMED, "extension requests require an id"))
+            call.target = msg.method
+            call.arguments = {
+                key: value
+                for key, value in msg.params.items()
+                if key not in {"_meta", "inputResponses", "requestState"}
+            }
+        return call
 
     def build_call(self, operation: Operation, msg: Incoming, params: Params) -> Call:
         target: str | None = None
@@ -283,7 +306,10 @@ class Adapter(ABC):
         caps: dict[str, Any] = {}
         if registry.tools:
             caps["tools"] = {"listChanged": True}
-        if registry.resources_fixed or registry.resources_templated:
+        if any(
+            self.describe_resource(spec) is not None
+            for spec in (*registry.resources_fixed.values(), *registry.resources_templated)
+        ):
             caps["resources"] = {"listChanged": True, "subscribe": True}
         if registry.prompts:
             caps["prompts"] = {"listChanged": True}
@@ -300,7 +326,11 @@ class Adapter(ABC):
     def describe_tool(self, spec: ToolSpec) -> ToolDef | None: ...
 
     def describe_resource(self, spec: ResourceSpec) -> ResourceDef | ResourceTemplateDef | None:
-        """Resource definitions are shared across revisions."""
+        """Project extension resources onto the URI understood by this revision."""
+        if spec.legacy_only and self.supports_extensions:
+            return None
+        if spec.definition is not None and spec.legacy_uri and not self.supports_extensions:
+            return spec.definition.model_copy(update={"uri": spec.legacy_uri})
         return spec.definition if spec.definition is not None else spec.template
 
     def describe_prompt(self, spec: PromptSpec) -> PromptDef | None:
@@ -319,3 +349,4 @@ class Adapter(ABC):
     allows_batch: ClassVar[bool] = False
     #: Negotiate once via initialize; retain the revision and capabilities in a session.
     has_handshake: ClassVar[bool] = False
+    supports_extensions: ClassVar[bool] = False

{aiohttp_tiny_mcp-0.3.0 → aiohttp_tiny_mcp-0.3.2}/src/aiohttp_tiny_mcp/client_base.py

@@ -144,6 +144,22 @@ class BaseClient(ABC):
         method = self.adapter.method_for(operation)
         if method is None:
             raise ValueError(f"{self.adapter.version} does not expose {operation}")
+        return await self.request_method(method, params, name=name)
+
+    async def request_method(
+        self,
+        method: str,
+        params: Params | Mapping[str, Any] | None = None,
+        *,
+        name: str | None = None,
+    ) -> dict[str, Any]:
+        """Call a named method, including extensions, with protocol metadata and headers.
+
+        Check server discovery for the extension before using its methods.
+        Results are returned as wire dictionaries; RPC errors raise ClientError.
+        """
+        if not isinstance(params, Params):
+            params = Params.model_validate(dict(params or {}))
         params = self.adapter.client_decorate_params(params, self.profile)
         envelope = {
             "jsonrpc": "2.0",

{aiohttp_tiny_mcp-0.3.0 → aiohttp_tiny_mcp-0.3.2}/src/aiohttp_tiny_mcp/console/console.css

@@ -151,7 +151,7 @@ button.quiet { color: var(--ink-soft); }
 @media (max-width: 900px) {
   /* Avoid auto rows distributing spare height to collapsed panels. */
   .layout {
-    grid-template-columns: 1fr;
+    grid-template-columns: minmax(0, 1fr);
     grid-template-rows: auto minmax(0, 1fr) auto;
   }
   .layout > .panel { min-height: 0; }
@@ -164,6 +164,8 @@ button.quiet { color: var(--ink-soft); }
   display: flex;
   flex-direction: column;
   min-height: 0;
+  min-width: 0;
+  overflow-wrap: anywhere;
 }
 
 .panel-head {
@@ -183,12 +185,14 @@ button.quiet { color: var(--ink-soft); }
   color: var(--ink-soft);
   margin: 0;
   flex: 1;
+  min-width: 0;
   overflow: hidden;
   text-overflow: ellipsis;
   white-space: nowrap;
 }
 
 .work .panel-head h2 { text-transform: none; letter-spacing: 0; font-size: 14px; color: var(--ink); font-family: var(--mono); }
+.panel-head > button { flex-shrink: 0; }
 
 .scroll { flex: 1; overflow: auto; padding: 12px 14px; min-height: 0; }
 
@@ -246,6 +250,8 @@ button.quiet { color: var(--ink-soft); }
 .item {
   display: block;
   width: 100%;
+  min-width: 0;
+  overflow-wrap: anywhere;
   text-align: left;
   border: 1px solid transparent;
   background: transparent;
@@ -301,7 +307,7 @@ button.quiet { color: var(--ink-soft); }
   border: 1px solid var(--line);
   border-radius: 4px;
   padding: 1px 4px;
-  white-space: nowrap;
+  white-space: normal;
 }
 
 .about pre {
@@ -371,10 +377,10 @@ button.quiet { color: var(--ink-soft); }
 button.tiny { font-size: 11px; padding: 1px 7px; }
 
 
-/* minmax(0, ...) prevents long keys from consuming the value column. */
+/* Cap long keys so values and copy controls keep usable space. */
 .fields {
   display: grid;
-  grid-template-columns: minmax(0, auto) minmax(0, 1fr);
+  grid-template-columns: fit-content(35%) minmax(0, 1fr);
   gap: 3px 14px;
   align-items: baseline;
 }
@@ -385,7 +391,8 @@ button.tiny { font-size: 11px; padding: 1px 7px; }
 .field-name {
   color: var(--ink-soft);
   font-size: 12px;
-  white-space: nowrap;
+  min-width: 0;
+  white-space: normal;
   overflow-wrap: anywhere;
 }