mcp-api-test 0.1.4__tar.gz → 0.2.0__tar.gz

{mcp_api_test-0.1.4/src/mcp_api_test.egg-info → mcp_api_test-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-api-test
-Version: 0.1.4
+Version: 0.2.0
 Summary: MCP server for testing REST API with built-in assertions
 Author: Ryan Febriansyah
 License-Expression: MIT
@@ -18,13 +18,14 @@ Classifier: Topic :: Software Development :: Testing
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: mcp<2.0.0,>=1.0.0
+Requires-Dist: mcp<3.0.0,>=2.0.0
 Requires-Dist: httpx
 Requires-Dist: python-dotenv
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-asyncio; extra == "dev"
 Requires-Dist: respx; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
 Provides-Extra: docs
 Requires-Dist: mkdocs-material; extra == "docs"
 Dynamic: license-file
@@ -39,6 +40,8 @@ Unlike traditional testing frameworks, `mcp-api-test` exposes API testing as a *
 
 It complements (rather than replaces) tools like pytest, Postman, and Playwright.
 
+> **Breaking changes in v0.2.0.** The server now runs on `mcp` 2.x, and the package layout moved from flat top-level modules to a proper `mcp_api_test` package. If you import internals directly, you may update to `from mcp_api_test.server import ...`. MCP client configuration (OpenCode, Claude Desktop, Claude Code) is unaffected. See the [changelog](docs/changelog.md) for details.
+
 ## Use cases
 
 - **QA & test engineering**: prompt an agent with natural language instead of crafting Postman requests

{mcp_api_test-0.1.4 → mcp_api_test-0.2.0}/README.md

@@ -8,6 +8,8 @@ Unlike traditional testing frameworks, `mcp-api-test` exposes API testing as a *
 
 It complements (rather than replaces) tools like pytest, Postman, and Playwright.
 
+> **Breaking changes in v0.2.0.** The server now runs on `mcp` 2.x, and the package layout moved from flat top-level modules to a proper `mcp_api_test` package. If you import internals directly, you may update to `from mcp_api_test.server import ...`. MCP client configuration (OpenCode, Claude Desktop, Claude Code) is unaffected. See the [changelog](docs/changelog.md) for details.
+
 ## Use cases
 
 - **QA & test engineering**: prompt an agent with natural language instead of crafting Postman requests

{mcp_api_test-0.1.4 → mcp_api_test-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mcp-api-test"
-version = "0.1.4"
+version = "0.2.0"
 description = "MCP server for testing REST API with built-in assertions"
 readme = "README.md"
 license = "MIT"
@@ -10,7 +10,7 @@ authors = [
 
 requires-python = ">=3.10"
 dependencies = [
-  "mcp>=1.0.0,<2.0.0",
+  "mcp>=2.0.0,<3.0.0",
   "httpx",
   "python-dotenv"
 ]
@@ -31,7 +31,7 @@ classifiers = [
 ]
 
 [project.scripts]
-mcp-api-test = "server:main"
+mcp-api-test = "mcp_api_test.server:main"
 
 [build-system]
 requires = ["setuptools>=61"]
@@ -39,8 +39,20 @@ build-backend = "setuptools.build_meta"
 
 [tool.setuptools]
 package-dir = {"" = "src"}
-py-modules = ["server", "__main__", "logger", "models", "utils", "flags"]
+packages = ["mcp_api_test"]
+
+[tool.setuptools.package-data]
+mcp_api_test = ["py.typed"]
 
 [project.optional-dependencies]
-dev = ["pytest", "pytest-asyncio", "respx"]
-docs = ["mkdocs-material"]
+dev = ["pytest", "pytest-asyncio", "respx", "mypy"]
+docs = ["mkdocs-material"]
+
+[tool.mypy]
+python_version = "3.10"
+packages = ["mcp_api_test"]
+check_untyped_defs = true
+disallow_untyped_defs = true
+no_implicit_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true

mcp_api_test-0.2.0/src/mcp_api_test/__init__.py

@@ -0,0 +1,3 @@
+"""Lightweight MCP for REST API testing for Claude Desktop and OpenCode"""
+
+__version__ = "0.2.0"

{mcp_api_test-0.1.4/src → mcp_api_test-0.2.0/src/mcp_api_test}/__main__.py

@@ -1,6 +1,6 @@
 """Entry point for the initialize mcp-api-test package when run as a module"""
 
-from src.server import mcp
+from .server import mcp
 
 if __name__ == "__main__":
     mcp.run()

{mcp_api_test-0.1.4/src → mcp_api_test-0.2.0/src/mcp_api_test}/flags.py

@@ -28,7 +28,7 @@ CURL_VALUE_FLAGS: dict[str, str] = {
 }
 
 # standalone flags with no following value
-CURL_BOOLEAN_FLAGS: dict[str, str] = {
+CURL_BOOLEAN_FLAGS: set[str] = {
     "-L",
     "--location",  # follow redirects, very common in browser exports
     "-k",

{mcp_api_test-0.1.4/src → mcp_api_test-0.2.0/src/mcp_api_test}/logger.py

@@ -1,5 +1,6 @@
 import logging
 import os
+from typing import Any
 
 
 class Logger:
@@ -31,7 +32,7 @@ class Logger:
 
             self.logger.addHandler(file_handler)
 
-    def info(self, message: str, *args, **kwargs) -> None:
+    def info(self, message: str, *args: Any, **kwargs: Any) -> None:
         """
         Log an info message with particular arguments
         """
@@ -39,7 +40,7 @@ class Logger:
             message = message % args
         self.logger.info(message, **kwargs)
 
-    def warning(self, message: str, *args, **kwargs) -> None:
+    def warning(self, message: str, *args: Any, **kwargs: Any) -> None:
         """
         Log a warning message with particular arguments
         """
@@ -47,7 +48,7 @@ class Logger:
             message = message % args
         self.logger.warning(message, **kwargs)
 
-    def error(self, message: str, *args, **kwargs) -> None:
+    def error(self, message: str, *args: Any, **kwargs: Any) -> None:
         """
         Log an error message with particular arguments
         """

{mcp_api_test-0.1.4/src → mcp_api_test-0.2.0/src/mcp_api_test}/server.py

@@ -2,26 +2,26 @@ import json
 import shlex
 import time
 import httpx
-from logger import get_logger
 from dotenv import load_dotenv
 from urllib.parse import urlparse
 from typing import Optional, Dict, Any, List
-from mcp.server.fastmcp import FastMCP
-from models import APITestResult, AssertionResult
-from utils import (
+from mcp.server.mcpserver import MCPServer
+from .logger import get_logger
+from .models import APITestResult, AssertionResult
+from .utils import (
     render_console_template_result,
     render_error_result,
     build_fullpath_url,
     get_nested_fields,
 )
-from flags import CURL_BOOLEAN_FLAGS, CURL_VALUE_FLAGS, CURL_WARN_FLAGS
+from .flags import CURL_BOOLEAN_FLAGS, CURL_VALUE_FLAGS, CURL_WARN_FLAGS
 
 load_dotenv()
 
 logger = get_logger(name="mcp-api-testing")
 
 
-mcp = FastMCP("mcp-api-test")
+mcp = MCPServer("mcp-api-test")
 
 
 def parse_status_code_range(range_str: str) -> tuple[int, int]:
@@ -162,7 +162,7 @@ async def run_test_api(
     required_status_code_range: Optional[str] = None,
     required_response_fields: Optional[List[str]] = None,
     required_response_contains: Optional[str] = None,
-):
+) -> str:
     """
     Test a given API services, it will supports either:
 
@@ -192,19 +192,27 @@ async def run_test_api(
     full_path_url = build_fullpath_url(base_url=base_url, endpoint=endpoint)
     method = method.upper()
 
+    content: Optional[str] = None
+    json_payload: Optional[Dict[str, Any]] = None
+    if payload is not None:
+        # cURL parser may produce a raw string for non-JSON -d payloads
+        # (example: form-encoded data). Use content= to send as-is rather
+        # than json= which would double-encode the string.
+        if isinstance(payload, str):
+            content = payload
+        else:
+            json_payload = payload
+
     start_time = time.perf_counter()
     try:
         async with httpx.AsyncClient(timeout=30) as client:
-            kwargs = {"method": method, "url": full_path_url, "headers": headers}
-            if payload is not None:
-                # cURL parser may produce a raw string for non-JSON -d payloads
-                # (example: form-encoded data). Use content= to send as-is rather
-                # than json= which would double-encode the string.
-                if isinstance(payload, str):
-                    kwargs["content"] = payload
-                else:
-                    kwargs["json"] = payload
-            response = await client.request(**kwargs)
+            response = await client.request(
+                method=method,
+                url=full_path_url,
+                headers=headers,
+                content=content,
+                json=json_payload,
+            )
             end_time = time.perf_counter()
             response_time_ms = (end_time - start_time) * 1000
     except Exception as e:
@@ -223,7 +231,7 @@ async def run_test_api(
         )
         resp_body = response.text
 
-    assertions = []
+    assertions: List[Dict[str, Any]] = []
 
     if required_status_code is not None:
         passed = response.status_code == required_status_code
@@ -321,7 +329,7 @@ async def run_test_api(
 
 
 # expose this function so it can be called in toml files
-def main():
+def main() -> None:
     mcp.run()
 
 

{mcp_api_test-0.1.4/src → mcp_api_test-0.2.0/src/mcp_api_test}/utils.py

@@ -1,7 +1,7 @@
 """Utility functions for MCP API testing"""
 
 from typing import Any
-from models import APITestResult
+from .models import APITestResult
 
 
 def render_console_template_result(result: APITestResult) -> str:

{mcp_api_test-0.1.4 → mcp_api_test-0.2.0/src/mcp_api_test.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-api-test
-Version: 0.1.4
+Version: 0.2.0
 Summary: MCP server for testing REST API with built-in assertions
 Author: Ryan Febriansyah
 License-Expression: MIT
@@ -18,13 +18,14 @@ Classifier: Topic :: Software Development :: Testing
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: mcp<2.0.0,>=1.0.0
+Requires-Dist: mcp<3.0.0,>=2.0.0
 Requires-Dist: httpx
 Requires-Dist: python-dotenv
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-asyncio; extra == "dev"
 Requires-Dist: respx; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
 Provides-Extra: docs
 Requires-Dist: mkdocs-material; extra == "docs"
 Dynamic: license-file
@@ -39,6 +40,8 @@ Unlike traditional testing frameworks, `mcp-api-test` exposes API testing as a *
 
 It complements (rather than replaces) tools like pytest, Postman, and Playwright.
 
+> **Breaking changes in v0.2.0.** The server now runs on `mcp` 2.x, and the package layout moved from flat top-level modules to a proper `mcp_api_test` package. If you import internals directly, you may update to `from mcp_api_test.server import ...`. MCP client configuration (OpenCode, Claude Desktop, Claude Code) is unaffected. See the [changelog](docs/changelog.md) for details.
+
 ## Use cases
 
 - **QA & test engineering**: prompt an agent with natural language instead of crafting Postman requests

{mcp_api_test-0.1.4 → mcp_api_test-0.2.0}/src/mcp_api_test.egg-info/SOURCES.txt

@@ -2,12 +2,14 @@ LICENSE
 MANIFEST.in
 README.md
 pyproject.toml
-src/__main__.py
-src/flags.py
-src/logger.py
-src/models.py
-src/server.py
-src/utils.py
+src/mcp_api_test/__init__.py
+src/mcp_api_test/__main__.py
+src/mcp_api_test/flags.py
+src/mcp_api_test/logger.py
+src/mcp_api_test/models.py
+src/mcp_api_test/py.typed
+src/mcp_api_test/server.py
+src/mcp_api_test/utils.py
 src/mcp_api_test.egg-info/PKG-INFO
 src/mcp_api_test.egg-info/SOURCES.txt
 src/mcp_api_test.egg-info/dependency_links.txt
@@ -15,6 +17,7 @@ src/mcp_api_test.egg-info/entry_points.txt
 src/mcp_api_test.egg-info/requires.txt
 src/mcp_api_test.egg-info/top_level.txt
 tests/test_mcp_api_tools.py
+tests/test_mcp_server_compat.py
 tests/test_packaging.py
 tests/test_parse_curl_command.py
 tests/test_parse_status_code.py

mcp_api_test-0.2.0/src/mcp_api_test.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+mcp-api-test = mcp_api_test.server:main

{mcp_api_test-0.1.4 → mcp_api_test-0.2.0}/src/mcp_api_test.egg-info/requires.txt

@@ -1,4 +1,4 @@
-mcp<2.0.0,>=1.0.0
+mcp<3.0.0,>=2.0.0
 httpx
 python-dotenv
 
@@ -6,6 +6,7 @@ python-dotenv
 pytest
 pytest-asyncio
 respx
+mypy
 
 [docs]
 mkdocs-material

mcp_api_test-0.2.0/src/mcp_api_test.egg-info/top_level.txt

@@ -0,0 +1 @@
+mcp_api_test

{mcp_api_test-0.1.4 → mcp_api_test-0.2.0}/tests/test_mcp_api_tools.py

@@ -3,7 +3,7 @@
 import pytest
 import respx
 import httpx
-from src.server import run_test_api
+from mcp_api_test.server import run_test_api
 
 
 @pytest.mark.asyncio

mcp_api_test-0.2.0/tests/test_mcp_server_compat.py

@@ -0,0 +1,30 @@
+"""Regression tests for the mcp 2.x migration (FastMCP -> MCPServer)"""
+
+import pytest
+from mcp_api_test.server import mcp
+
+
+def test_server_is_built_on_mcpserver():
+    # regression: mcp 2.x removed mcp.server.fastmcp.FastMCP in favor of
+    # mcp.server.mcpserver.MCPServer; importing the old path now raises
+    # ModuleNotFoundError instead of silently breaking at a later call site
+    from mcp.server.mcpserver import MCPServer
+
+    assert isinstance(mcp, MCPServer)
+
+
+def test_old_fastmcp_import_path_is_gone():
+    # confirms we're actually running against the mcp 2.x line pinned in
+    # pyproject.toml, not an mcp 1.x install that would mask this migration
+    with pytest.raises(ModuleNotFoundError):
+        import mcp.server.fastmcp  # noqa: F401
+
+
+def test_run_test_api_is_registered_as_a_tool():
+    # @mcp.tool() kept the same decorator signature across the migration;
+    # this would fail if MCPServer's tool manager changed shape
+    import asyncio
+
+    tools = asyncio.run(mcp.list_tools())
+    tool_names = {tool.name for tool in tools}
+    assert "run_test_api" in tool_names

mcp_api_test-0.2.0/tests/test_packaging.py

@@ -0,0 +1,49 @@
+"""Static checks that the source layout matches the wheel packaging config"""
+
+import tomllib
+from pathlib import Path
+
+PROJECT_ROOT = Path(__file__).resolve().parents[1]
+PACKAGE_DIR = PROJECT_ROOT / "src" / "mcp_api_test"
+
+
+def _pyproject() -> dict:
+    with open(PROJECT_ROOT / "pyproject.toml", "rb") as f:
+        return tomllib.load(f)
+
+
+def _project_version() -> str:
+    return _pyproject()["project"]["version"]
+
+
+def test_declared_package_matches_src_directory():
+    packages = _pyproject()["tool"]["setuptools"]["packages"]
+    assert packages == ["mcp_api_test"]
+    assert PACKAGE_DIR.is_dir()
+
+
+def test_all_modules_exist_in_package_dir():
+    # regression: flat py-modules layout drifting from the package dir
+    expected = {"server", "utils", "models", "logger", "flags", "__init__", "__main__"}
+    actual = {p.stem for p in PACKAGE_DIR.glob("*.py")}
+    assert expected <= actual
+
+
+def test_py_typed_marker_exists_and_is_packaged():
+    # PEP 561: inline-typed packages must ship a py.typed marker
+    assert (PACKAGE_DIR / "py.typed").exists()
+
+    package_data = _pyproject()["tool"]["setuptools"]["package-data"]
+    assert "py.typed" in package_data.get("mcp_api_test", [])
+
+
+def test_entry_point_targets_the_package():
+    scripts = _pyproject()["project"]["scripts"]
+    assert scripts["mcp-api-test"] == "mcp_api_test.server:main"
+
+
+def test_version_matches_pyproject():
+    # regression: src/mcp_api_test/__init__.py __version__ drifted from pyproject.toml
+    import mcp_api_test
+
+    assert mcp_api_test.__version__ == _project_version()

{mcp_api_test-0.1.4 → mcp_api_test-0.2.0}/tests/test_parse_curl_command.py

@@ -1,9 +1,8 @@
 """Unit tests for the cURL command parser"""
 
 import logging
-
 import pytest
-from src.server import parse_curl_command
+from mcp_api_test.server import parse_curl_command
 
 
 def test_basic_curl_command():

{mcp_api_test-0.1.4 → mcp_api_test-0.2.0}/tests/test_parse_status_code.py

@@ -1,5 +1,5 @@
 import pytest
-from src.server import parse_status_code_range
+from mcp_api_test.server import parse_status_code_range
 
 
 @pytest.mark.parametrize(

{mcp_api_test-0.1.4 → mcp_api_test-0.2.0}/tests/test_utils.py

@@ -1,6 +1,6 @@
 """Unit tests for URL building helpers"""
 
-from src.utils import build_fullpath_url
+from mcp_api_test.utils import build_fullpath_url
 
 
 def test_empty_endpoint_returns_base_with_slash():

mcp_api_test-0.1.4/src/mcp_api_test.egg-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-mcp-api-test = server:main

mcp_api_test-0.1.4/src/mcp_api_test.egg-info/top_level.txt

@@ -1,6 +0,0 @@
-__main__
-flags
-logger
-models
-server
-utils

mcp_api_test-0.1.4/tests/test_packaging.py

@@ -1,46 +0,0 @@
-"""Static checks that the source layout matches the wheel packaging config"""
-
-import tomllib
-from pathlib import Path
-
-PROJECT_ROOT = Path(__file__).resolve().parents[1]
-SRC_DIR = PROJECT_ROOT / "src"
-
-
-def _packaged_modules() -> list[str]:
-    with open(PROJECT_ROOT / "pyproject.toml", "rb") as f:
-        config = tomllib.load(f)
-    return config["tool"]["setuptools"]["py-modules"]
-
-
-def _project_version() -> str:
-    with open(PROJECT_ROOT / "pyproject.toml", "rb") as f:
-        config = tomllib.load(f)
-    return config["project"]["version"]
-
-
-def test_all_src_modules_are_packaged():
-    src_modules = {
-        p.stem
-        for p in SRC_DIR.glob("*.py")
-        if p.name != "__init__.py" and not p.name.startswith("__")
-    }
-    missing = src_modules - set(_packaged_modules())
-    assert not missing, (
-        f"Modules in src/ that are missing from pyproject.toml "
-        f"[tool.setuptools] py-modules: {sorted(missing)}"
-    )
-
-
-def test_packaged_modules_exist_in_src():
-    for module in _packaged_modules():
-        assert (
-            SRC_DIR / f"{module}.py"
-        ).exists(), f"'{module}' is listed in py-modules but has no src/{module}.py"
-
-
-def test_version_matches_pyproject():
-    # regression: src/__init__.py __version__ drifted from pyproject.toml
-    import src
-
-    assert src.__version__ == _project_version()