aviationstack-mcp-server 0.1.0__tar.gz

aviationstack_mcp_server-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ravi Agarwal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

aviationstack_mcp_server-0.1.0/PKG-INFO

@@ -0,0 +1,57 @@
+Metadata-Version: 2.4
+Name: aviationstack-mcp-server
+Version: 0.1.0
+Summary: An open-source Model Context Protocol server for the Aviationstack aviation API.
+Keywords: mcp,model-context-protocol,aviationstack,aviation,flights,ai,llm
+Author: Ravi Agarwal
+Author-email: Ravi Agarwal <raviagrawal1121@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: mcp[cli]>=2.2.0
+Requires-Dist: pydantic>=2.13.5
+Requires-Dist: pydantic-settings>=2.15.0
+Requires-Dist: tenacity>=9.1.4
+Requires-Python: >=3.13
+Project-URL: Homepage, https://github.com/raviagrawal121/aviationstack-mcp-server
+Project-URL: Repository, https://github.com/raviagrawal121/aviationstack-mcp-server
+Project-URL: Issues, https://github.com/raviagrawal121/aviationstack-mcp-server/issues
+Project-URL: Changelog, https://github.com/raviagrawal121/aviationstack-mcp-server/blob/main/CHANGELOG.md
+Description-Content-Type: text/markdown
+
+# Aviationstack MCP Server
+
+MCP server providing aviation data through the Aviationstack API.
+
+## Development
+
+```bash
+uv sync
+source .venv/bin/activate
+```
+
+Normal tests are offline and do not require an Aviationstack API key:
+
+```bash
+uv run pytest -m "not live_api"
+```
+
+Run the live MCP-to-Aviationstack test explicitly with `AVIATIONSTACK_API_KEY`
+set in the environment or `.env`:
+
+```bash
+uv run pytest -m live_api
+```
+
+Probe endpoint access for the configured account, using one bounded request per
+capability:
+
+```bash
+AVIATIONSTACK_LIVE=1 uv run pytest -m capability_discovery -s
+```

aviationstack_mcp_server-0.1.0/README.md

@@ -0,0 +1,30 @@
+# Aviationstack MCP Server
+
+MCP server providing aviation data through the Aviationstack API.
+
+## Development
+
+```bash
+uv sync
+source .venv/bin/activate
+```
+
+Normal tests are offline and do not require an Aviationstack API key:
+
+```bash
+uv run pytest -m "not live_api"
+```
+
+Run the live MCP-to-Aviationstack test explicitly with `AVIATIONSTACK_API_KEY`
+set in the environment or `.env`:
+
+```bash
+uv run pytest -m live_api
+```
+
+Probe endpoint access for the configured account, using one bounded request per
+capability:
+
+```bash
+AVIATIONSTACK_LIVE=1 uv run pytest -m capability_discovery -s
+```

aviationstack_mcp_server-0.1.0/pyproject.toml

@@ -0,0 +1,88 @@
+[project]
+name = "aviationstack-mcp-server"
+version = "0.1.0"
+description = "An open-source Model Context Protocol server for the Aviationstack aviation API."
+readme = "README.md"
+requires-python = ">=3.13"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = [
+    "mcp",
+    "model-context-protocol",
+    "aviationstack",
+    "aviation",
+    "flights",
+    "ai",
+    "llm",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "httpx>=0.28.1",
+    "mcp[cli]>=2.2.0",
+    "pydantic>=2.13.5",
+    "pydantic-settings>=2.15.0",
+    "tenacity>=9.1.4",
+]
+
+[[project.authors]]
+name = "Ravi Agarwal"
+email = "raviagrawal1121@gmail.com"
+
+[project.scripts]
+aviationstack-mcp-server = "aviationstack_mcp_server.__main__:main"
+
+[project.urls]
+Homepage = "https://github.com/raviagrawal121/aviationstack-mcp-server"
+Repository = "https://github.com/raviagrawal121/aviationstack-mcp-server"
+Issues = "https://github.com/raviagrawal121/aviationstack-mcp-server/issues"
+Changelog = "https://github.com/raviagrawal121/aviationstack-mcp-server/blob/main/CHANGELOG.md"
+
+[build-system]
+requires = ["uv_build>=0.12.10,<0.13.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "mypy>=2.3.1",
+    "pytest>=9.1.1",
+    "pytest-asyncio>=1.4.0",
+    "pytest-cov>=6.1.1",
+    "ruff>=0.16.6",
+]
+
+[tool.ruff]
+line-length = 100
+target-version = "py313"
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "F",
+    "I",
+    "UP",
+    "B",
+]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+markers = [
+    "live_api: tests that call the live Aviationstack API",
+    "capability_discovery: opt-in live tests that probe API access by endpoint",
+]
+
+[tool.mypy]
+python_version = "3.13"
+plugins = ["pydantic.mypy"]
+
+[tool.pydantic-mypy]
+init_forbid_extra = true
+init_typed = true
+warn_required_dynamic_aliases = true

aviationstack_mcp_server-0.1.0/pyproject.toml.orig

@@ -0,0 +1,89 @@
+[project]
+name = "aviationstack-mcp-server"
+version = "0.1.0"
+description = "An open-source Model Context Protocol server for the Aviationstack aviation API."
+readme = "README.md"
+requires-python = ">=3.13"
+
+authors = [
+    { name = "Ravi Agarwal", email = "raviagrawal1121@gmail.com" },
+]
+
+license = "MIT"
+license-files = ["LICENSE"]
+
+keywords = [
+    "mcp",
+    "model-context-protocol",
+    "aviationstack",
+    "aviation",
+    "flights",
+    "ai",
+    "llm",
+]
+
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+dependencies = [
+    "httpx>=0.28.1",
+    "mcp[cli]>=2.2.0",
+    "pydantic>=2.13.5",
+    "pydantic-settings>=2.15.0",
+    "tenacity>=9.1.4",
+]
+
+[project.scripts]
+aviationstack-mcp-server = "aviationstack_mcp_server.__main__:main"
+
+[project.urls]
+Homepage = "https://github.com/raviagrawal121/aviationstack-mcp-server"
+Repository = "https://github.com/raviagrawal121/aviationstack-mcp-server"
+Issues = "https://github.com/raviagrawal121/aviationstack-mcp-server/issues"
+Changelog = "https://github.com/raviagrawal121/aviationstack-mcp-server/blob/main/CHANGELOG.md"
+
+[build-system]
+requires = ["uv_build>=0.12.10,<0.13.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "mypy>=2.3.1",
+    "pytest>=9.1.1",
+    "pytest-asyncio>=1.4.0",
+    "pytest-cov>=6.1.1",
+    "ruff>=0.16.6",
+]
+
+[tool.ruff]
+line-length = 100
+target-version = "py313"
+
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+markers = [
+    "live_api: tests that call the live Aviationstack API",
+    "capability_discovery: opt-in live tests that probe API access by endpoint",
+]
+
+
+[tool.mypy]
+python_version = "3.13"
+plugins = ["pydantic.mypy"]
+
+[tool.pydantic-mypy]
+init_forbid_extra = true
+init_typed = true
+warn_required_dynamic_aliases = true
+

aviationstack_mcp_server-0.1.0/src/aviationstack_mcp_server/__main__.py

@@ -0,0 +1,15 @@
+from aviationstack_mcp_server.config import get_settings
+from aviationstack_mcp_server.logging_config import configure_logging
+from aviationstack_mcp_server.mcp.server import create_server
+
+
+def main() -> None:
+    settings = get_settings()
+    configure_logging(settings.log_level)
+
+    server = create_server()
+    server.run()
+
+
+if __name__ == "__main__":
+    main()

aviationstack_mcp_server-0.1.0/src/aviationstack_mcp_server/client/__init__.py

@@ -0,0 +1,9 @@
+from .aviationstack import AviationstackClient
+from .factory import create_aviationstack_client
+from .http import HTTPClient
+
+__all__ = [
+    "AviationstackClient",
+    "HTTPClient",
+    "create_aviationstack_client",
+]

aviationstack_mcp_server-0.1.0/src/aviationstack_mcp_server/client/aviationstack.py

@@ -0,0 +1,138 @@
+from __future__ import annotations
+
+import logging
+from collections.abc import Mapping
+from typing import Any
+
+from aviationstack_mcp_server.client.http import HTTPClient
+from aviationstack_mcp_server.config import Settings
+from aviationstack_mcp_server.errors import (
+    AviationstackAPIError,
+)
+from aviationstack_mcp_server.security import validate_endpoint
+
+logger = logging.getLogger(__name__)
+
+
+class AviationstackClient:
+    """Asynchronous client for the Aviationstack REST API."""
+
+    def __init__(
+        self,
+        settings: Settings,
+        http_client: HTTPClient,
+    ) -> None:
+        self._settings = settings
+        self._http_client = http_client
+
+    async def get(
+        self,
+        endpoint: str,
+        *,
+        params: Mapping[str, Any] | None = None,
+    ) -> dict[str, Any]:
+        """Perform a GET request against an Aviationstack endpoint."""
+
+        url = self._build_url(endpoint)
+
+        request_params = {
+            "access_key": self._settings.aviationstack_api_key.get_secret_value(),
+        }
+
+        if params:
+            request_params.update(
+                {key: value for key, value in params.items() if value is not None}
+            )
+
+        logger.debug(
+            "Sending Aviationstack request: method=%s endpoint=%s params=%s",
+            "GET",
+            endpoint,
+            sorted(key for key in request_params if key != "access_key"),
+        )
+
+        response = await self._http_client.request(
+            "GET",
+            url,
+            params=request_params,
+        )
+
+        logger.debug(
+            "Received Aviationstack response: method=%s endpoint=%s status=%s",
+            "GET",
+            endpoint,
+            response.status_code,
+        )
+
+        payload = self._parse_response(response)
+
+        self._raise_for_api_error(payload)
+
+        return payload
+
+    async def close(self) -> None:
+        logger.debug("Closing Aviationstack HTTP client")
+        await self._http_client.close()
+
+    def _build_url(self, endpoint: str) -> str:
+        """Build an endpoint URL safely."""
+
+        validate_endpoint(endpoint)
+        normalized_base_url = self._settings.aviationstack_base_url.rstrip("/")
+        normalized_endpoint = endpoint.strip("/")
+
+        return f"{normalized_base_url}/{normalized_endpoint}"
+
+    @staticmethod
+    def _parse_response(response: Any) -> dict[str, Any]:
+        """Parse an Aviationstack JSON response."""
+
+        try:
+            payload = response.json()
+        except ValueError as exc:
+            logger.warning("Aviationstack returned invalid JSON")
+            raise AviationstackAPIError("Aviationstack returned an invalid JSON response.") from exc
+
+        if not isinstance(payload, dict):
+            logger.warning(
+                "Aviationstack returned an unexpected response type: %s",
+                type(payload).__name__,
+            )
+            raise AviationstackAPIError("Aviationstack returned an unexpected response format.")
+
+        return payload
+
+    @staticmethod
+    def _raise_for_api_error(
+        payload: dict[str, Any],
+    ) -> None:
+        """Translate Aviationstack application-level errors."""
+
+        error = payload.get("error")
+
+        if not isinstance(error, dict):
+            return
+
+        error_type = error.get("type")
+        error_code = error.get("code")
+        message = error.get("message")
+
+        if not isinstance(error_type, str):
+            error_type = "api_error"
+
+        if not isinstance(error_code, str):
+            error_code = None
+
+        if not isinstance(message, str):
+            message = "Aviationstack returned an API error."
+
+        logger.warning(
+            "Aviationstack API error: type=%s code=%s",
+            error_type,
+            error_code,
+        )
+
+        raise AviationstackAPIError(
+            f"{error_type}: {message}",
+            error_code=error_code,
+        )

aviationstack_mcp_server-0.1.0/src/aviationstack_mcp_server/client/factory.py

@@ -0,0 +1,30 @@
+import logging
+
+from aviationstack_mcp_server.client.aviationstack import AviationstackClient
+from aviationstack_mcp_server.client.http import HTTPClient
+from aviationstack_mcp_server.config import Settings
+
+logger = logging.getLogger(__name__)
+
+
+def create_aviationstack_client(
+    settings: Settings,
+) -> AviationstackClient:
+    """Create a configured Aviationstack API client."""
+
+    logger.debug(
+        "Creating Aviationstack client: base_url=%s connect_timeout=%s "
+        "read_timeout=%s max_retries=%s retry_backoff=%s",
+        settings.aviationstack_base_url,
+        settings.aviationstack_connect_timeout,
+        settings.aviationstack_read_timeout,
+        settings.aviationstack_retry_max_attempts,
+        settings.aviationstack_retry_backoff_factor,
+    )
+
+    http_client = HTTPClient(settings)
+
+    return AviationstackClient(
+        settings=settings,
+        http_client=http_client,
+    )