rationalbloks-mcp 0.1.14__tar.gz → 0.1.19__tar.gz

{rationalbloks_mcp-0.1.14 → rationalbloks_mcp-0.1.19}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rationalbloks-mcp
-Version: 0.1.14
+Version: 0.1.19
 Summary: Enterprise-grade MCP Server for RationalBloks - Connect AI agents to your backend projects
 Project-URL: Homepage, https://rationalbloks.com
 Project-URL: Documentation, https://rationalbloks.com/docs/mcp

{rationalbloks_mcp-0.1.14 → rationalbloks_mcp-0.1.19}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "rationalbloks-mcp"
-version = "0.1.14"
+version = "0.1.19"
 description = "Enterprise-grade MCP Server for RationalBloks - Connect AI agents to your backend projects"
 readme = "README.md"
 license = {text = "Proprietary"}

{rationalbloks_mcp-0.1.14 → rationalbloks_mcp-0.1.19}/src/rationalbloks_mcp/__init__.py

@@ -26,15 +26,17 @@ from .server import RationalBloksMCPServer
 from .client import RationalBloksClient
 from .tools import TOOLS
 
-# Version - single source of truth read from pyproject.toml metadata
-try:
-    from importlib.metadata import version as _get_version
-    __version__ = _get_version("rationalbloks-mcp")
-except Exception:
-    __version__ = "0.1.10"  # Fallback matches pyproject.toml
+# ============================================================================
+# VERSION - Single Source of Truth (Chain Mantra)
+# ============================================================================
+# Read from pyproject.toml via importlib.metadata
+# If this fails, the package is not installed correctly - fail immediately
+# NO FALLBACKS - there is only ONE correct path
+from importlib.metadata import version as _get_version
+__version__ = _get_version("rationalbloks-mcp")
 
 __author__ = "RationalBloks"
-__all__ = ["RationalBloksMCPServer", "RationalBloksClient", "TOOLS", "main"]
+__all__ = ["RationalBloksMCPServer", "RationalBloksClient", "TOOLS", "main", "__version__"]
 
 
 def main() -> None:

{rationalbloks_mcp-0.1.14 → rationalbloks_mcp-0.1.19}/src/rationalbloks_mcp/client.py

@@ -21,12 +21,19 @@ import os
 import time
 from typing import Any
 
-# Version - read dynamically to avoid circular import
-try:
-    from importlib.metadata import version as _get_version
-    __version__ = _get_version("rationalbloks-mcp")
-except Exception:
-    __version__ = "0.1.10"
+# ============================================================================
+# VERSION - Import from package root (Chain Mantra: Single Source of Truth)
+# ============================================================================
+# Deferred import to avoid circular dependency during module loading
+# The version is set after the module is fully loaded via __init__.py
+_version_cache: str | None = None
+
+def _get_version() -> str:
+    global _version_cache
+    if _version_cache is None:
+        from importlib.metadata import version
+        _version_cache = version("rationalbloks-mcp")
+    return _version_cache
 
 # Default configuration (can be overridden via environment variables)
 GATEWAY_URL = os.environ.get("RATIONALBLOKS_BASE_URL", "https://logicblok.rationalbloks.com")
@@ -34,6 +41,9 @@ REQUEST_TIMEOUT = float(os.environ.get("RATIONALBLOKS_TIMEOUT", "30"))
 MAX_RETRIES = 3
 RETRY_DELAY = 1.0  # Base delay in seconds, exponentially increases
 
+# Public API
+__all__ = ["RationalBloksClient"]
+
 
 class RationalBloksClient:
     # HTTP client for MCP Gateway communication
@@ -59,7 +69,7 @@ class RationalBloksClient:
             headers={
                 "Authorization": f"Bearer {api_key}",
                 "Content-Type": "application/json",
-                "User-Agent": f"rationalbloks-mcp/{__version__}"
+                "User-Agent": f"rationalbloks-mcp/{_get_version()}"
             },
             timeout=self.timeout,
             follow_redirects=True

{rationalbloks_mcp-0.1.14 → rationalbloks_mcp-0.1.19}/src/rationalbloks_mcp/server.py

@@ -38,19 +38,23 @@ from mcp.types import (
     PromptArgument,
     PromptMessage,
     GetPromptResult,
-    Resource
+    Resource,
+    Icon
 )
 from starlette.requests import Request
 
 from .client import RationalBloksClient
 from .tools import TOOLS
 
-# Version - read dynamically to avoid circular import
-try:
-    from importlib.metadata import version as _get_version
-    __version__ = _get_version("rationalbloks-mcp")
-except Exception:
-    __version__ = "0.1.10"
+# ============================================================================
+# VERSION - Import from package root (Chain Mantra: Single Source of Truth)
+# ============================================================================
+# Deferred import to avoid circular dependency during module loading
+from importlib.metadata import version as _get_pkg_version
+__version__ = _get_pkg_version("rationalbloks-mcp")
+
+# Public API
+__all__ = ["RationalBloksMCPServer"]
 
 
 # ============================================================================
@@ -159,6 +163,10 @@ class RationalBloksMCPServer:
             version=__version__,
             instructions="RationalBloks MCP Server - Enterprise Backend-as-a-Service for AI agents. Build production APIs from JSON schemas.",
             website_url="https://rationalbloks.com",
+            icons=[
+                Icon(src="https://rationalbloks.com/logo.svg", mimeType="image/svg+xml"),
+                Icon(src="https://rationalbloks.com/logo.png", mimeType="image/png", sizes=["128x128"]),
+            ],
         )
         self._setup_handlers()
     
@@ -346,19 +354,22 @@ class RationalBloksMCPServer:
                                 description=f"Deployment status and metadata for {project_name}",
                                 mimeType="application/json"
                             ))
-                except Exception:
-                    # Fail silently for dynamic resources
-                    # WHY: Static resources still available
-                    pass
+                except Exception as e:
+                    # Log warning but continue - static resources are still available
+                    # Chain Mantra: Dynamic resources are optional, but failures must be visible
+                    print(f"[rationalbloks-mcp] Warning: Failed to list dynamic resources: {e}", file=sys.stderr)
             
             return resources
         
         @self.server.read_resource()
-        async def read_resource(uri: str) -> str:
+        async def read_resource(uri) -> str:
             # Read a specific resource by URI
             # Handles both static docs and dynamic project resources
             # WHY: Provides AI agents access to docs and project schemas
             
+            # Convert AnyUrl to string for comparison
+            uri_str = str(uri)
+            
             # Static documentation resources - no auth required
             static_docs = {
                 "rationalbloks://docs/getting-started": DOCS_GETTING_STARTED,
@@ -366,8 +377,8 @@ class RationalBloksMCPServer:
                 "rationalbloks://docs/api-reference": DOCS_API_REFERENCE,
             }
             
-            if uri in static_docs:
-                return static_docs[uri]
+            if uri_str in static_docs:
+                return static_docs[uri_str]
             
             # Dynamic project resources - require authentication
             client = self._get_client_for_request()
@@ -375,12 +386,12 @@ class RationalBloksMCPServer:
                 raise ValueError("Authentication required to read project resources")
             
             # Parse URI: rationalbloks://project/{id}/{type}
-            if not uri.startswith("rationalbloks://project/"):
-                raise ValueError(f"Invalid URI format: {uri}")
+            if not uri_str.startswith("rationalbloks://project/"):
+                raise ValueError(f"Invalid URI format: {uri_str}")
             
-            parts = uri.replace("rationalbloks://project/", "").split("/")
+            parts = uri_str.replace("rationalbloks://project/", "").split("/")
             if len(parts) != 2:
-                raise ValueError(f"Invalid URI format: {uri}")
+                raise ValueError(f"Invalid URI format: {uri_str}")
             
             project_id, resource_type = parts
             
@@ -399,9 +410,14 @@ class RationalBloksMCPServer:
         @self.server.call_tool()
         async def call_tool(name: str, arguments: dict) -> list[TextContent]:
             # Execute a tool with provided arguments
-            # Single code path: get client → execute → format response
+            # Single code path: validate → get client → execute → format response
             # WHY: Core MCP operation - all tool invocations flow through here
             
+            # Validate tool name exists
+            valid_tools = [t["name"] for t in TOOLS]
+            if name not in valid_tools:
+                raise ValueError(f"Unknown tool: {name}")
+            
             try:
                 client = self._get_client_for_request()
                 
@@ -429,24 +445,33 @@ class RationalBloksMCPServer:
         # Get the appropriate client for the current request
         # STDIO mode: Returns pre-configured client with environment API key
         # HTTP mode: Extracts API key from Authorization Bearer header per-request
-        # WHY: Dual transport requires different authentication strategies
+        # Chain Mantra: Single path through code, explicit None returns
         
+        # STDIO mode - return pre-configured client
         if not self.http_mode:
             return self.client
         
         # HTTP mode - extract API key from Authorization: Bearer header
-        try:
-            ctx = self.server.request_context
-            if ctx.request and isinstance(ctx.request, Request):
-                auth_header = ctx.request.headers.get("authorization", "")
-                if auth_header.startswith("Bearer "):
-                    api_key = auth_header[7:]  # Remove "Bearer " prefix
-                    if api_key.startswith("rb_sk_"):
-                        return RationalBloksClient(api_key)
-        except (LookupError, AttributeError):
-            pass
+        BEARER_PREFIX = "Bearer "
+        
+        # Get request context (may not exist if called outside request)
+        ctx = getattr(self.server, 'request_context', None)
+        if ctx is None:
+            return None
+        
+        request = getattr(ctx, 'request', None)
+        if request is None or not isinstance(request, Request):
+            return None
+        
+        auth_header = request.headers.get("authorization", "")
+        if not auth_header.startswith(BEARER_PREFIX):
+            return None
+        
+        api_key = auth_header[len(BEARER_PREFIX):]
+        if not api_key.startswith("rb_sk_"):
+            return None
         
-        return None
+        return RationalBloksClient(api_key)
     
     def _get_init_options(self) -> InitializationOptions:
         # Get MCP initialization options for STDIO transport
@@ -544,11 +569,13 @@ class RationalBloksMCPServer:
                 "configSchema": {
                     "type": "object",
                     "title": "RationalBloks Configuration",
+                    "required": [],  # All properties are optional - Smithery quality score
                     "properties": {
                         "apiKey": {
                             "type": "string",
                             "title": "API Key",
-                            "description": "Your RationalBloks API key (get it from https://rationalbloks.com/settings)",
+                            "description": "Your RationalBloks API key (get it from https://rationalbloks.com/settings). Optional for browsing documentation.",
+                            "default": "",
                             "x-from": {"header": "authorization"}
                         },
                         "baseUrl": {
@@ -570,8 +597,7 @@ class RationalBloksMCPServer:
                             "default": "INFO",
                             "enum": ["DEBUG", "INFO", "WARNING", "ERROR"]
                         }
-                    },
-                    "required": ["apiKey"]
+                    }
                 }
             })
         
@@ -599,12 +625,18 @@ class RationalBloksMCPServer:
                 yield
         
         # Build Starlette ASGI application
+        # Multiple paths for MCP endpoint compatibility:
+        # - /sse: SSE endpoint for Smithery and cloud clients (documented URL)
+        # - /mcp: Alternative path for clarity
+        # - /: Root fallback for direct connections
         app = Starlette(
             debug=False,
             routes=[
                 Route("/.well-known/mcp/server-card.json", endpoint=server_card, methods=["GET"]),
                 Route("/health", endpoint=health, methods=["GET"]),
-                Mount("/", app=handle_streamable),  # MCP JSON-RPC endpoint at root
+                Mount("/sse", app=handle_streamable),    # Primary SSE endpoint (matches frontend docs)
+                Mount("/mcp", app=handle_streamable),    # Alternative MCP path
+                Mount("/", app=handle_streamable),       # Root fallback for direct connections
             ],
             lifespan=lifespan,
         )
@@ -624,6 +656,9 @@ class RationalBloksMCPServer:
         host = os.environ.get("HOST", "0.0.0.0")
         
         print(f"[rationalbloks-mcp] Streamable HTTP server starting on {host}:{port}", file=sys.stderr)
-        print(f"[rationalbloks-mcp] MCP endpoint: http://{host}:{port}/mcp", file=sys.stderr)
+        print(f"[rationalbloks-mcp] MCP endpoints:", file=sys.stderr)
+        print(f"[rationalbloks-mcp]   - http://{host}:{port}/sse (primary)", file=sys.stderr)
+        print(f"[rationalbloks-mcp]   - http://{host}:{port}/mcp (alternative)", file=sys.stderr)
+        print(f"[rationalbloks-mcp]   - http://{host}:{port}/ (root fallback)", file=sys.stderr)
         
         uvicorn.run(app, host=host, port=port, log_level="info")

{rationalbloks_mcp-0.1.14 → rationalbloks_mcp-0.1.19}/src/rationalbloks_mcp/tools.py

@@ -17,6 +17,9 @@
 #   - Write Operations (7): Create, update, deploy, delete
 # ============================================================================
 
+# Public API
+__all__ = ["TOOLS"]
+
 TOOLS = [
     # =========================================================================
     # READ TOOLS (11 total) - All readOnlyHint=True
@@ -45,6 +48,7 @@ TOOLS = [
         "description": "Get detailed information about a specific project",
         "inputSchema": {
             "type": "object",
+            "description": "Specify the project to retrieve",
             "properties": {
                 "project_id": {
                     "type": "string",
@@ -67,6 +71,7 @@ TOOLS = [
         "description": "Get the JSON schema definition of a project",
         "inputSchema": {
             "type": "object",
+            "description": "Specify the project whose schema to retrieve",
             "properties": {
                 "project_id": {
                     "type": "string",
@@ -107,6 +112,7 @@ TOOLS = [
         "description": "Check the status of a deployment job",
         "inputSchema": {
             "type": "object",
+            "description": "Specify the job to check",
             "properties": {
                 "job_id": {
                     "type": "string",
@@ -129,6 +135,7 @@ TOOLS = [
         "description": "Get detailed project info including deployment status and resource usage",
         "inputSchema": {
             "type": "object",
+            "description": "Specify the project to get info for",
             "properties": {
                 "project_id": {
                     "type": "string",
@@ -151,6 +158,7 @@ TOOLS = [
         "description": "Get the deployment and version history (git commits) for a project",
         "inputSchema": {
             "type": "object",
+            "description": "Specify the project to get history for",
             "properties": {
                 "project_id": {
                     "type": "string",
@@ -209,6 +217,7 @@ TOOLS = [
         "description": "Get resource usage metrics (CPU, memory) for a project",
         "inputSchema": {
             "type": "object",
+            "description": "Specify the project to get usage metrics for",
             "properties": {
                 "project_id": {
                     "type": "string",
@@ -231,6 +240,7 @@ TOOLS = [
         "description": "Get the schema as it was at a specific version/commit",
         "inputSchema": {
             "type": "object",
+            "description": "Specify the project and version to retrieve schema for",
             "properties": {
                 "project_id": {
                     "type": "string",
@@ -261,6 +271,7 @@ TOOLS = [
         "description": "Create a new RationalBloks project from a JSON schema",
         "inputSchema": {
             "type": "object",
+            "description": "Project name, schema definition, and optional description",
             "properties": {
                 "name": {
                     "type": "string",
@@ -291,6 +302,7 @@ TOOLS = [
         "description": "Update a project's schema (saves to database, does NOT deploy)",
         "inputSchema": {
             "type": "object",
+            "description": "Project to update and new schema definition",
             "properties": {
                 "project_id": {
                     "type": "string",
@@ -317,6 +329,7 @@ TOOLS = [
         "description": "Deploy a project to the staging environment",
         "inputSchema": {
             "type": "object",
+            "description": "Specify the project to deploy to staging",
             "properties": {
                 "project_id": {
                     "type": "string",
@@ -339,6 +352,7 @@ TOOLS = [
         "description": "Promote staging to production (requires paid plan)",
         "inputSchema": {
             "type": "object",
+            "description": "Specify the project to deploy to production",
             "properties": {
                 "project_id": {
                     "type": "string",
@@ -361,6 +375,7 @@ TOOLS = [
         "description": "Delete a project (removes GitHub repo, K8s deployments, and database)",
         "inputSchema": {
             "type": "object",
+            "description": "Specify the project to permanently delete",
             "properties": {
                 "project_id": {
                     "type": "string",
@@ -383,6 +398,7 @@ TOOLS = [
         "description": "Rollback a project to a previous version",
         "inputSchema": {
             "type": "object",
+            "description": "Project, version, and environment for rollback",
             "properties": {
                 "project_id": {
                     "type": "string",
@@ -413,6 +429,7 @@ TOOLS = [
         "description": "Rename a project (changes display name, not project_code)",
         "inputSchema": {
             "type": "object",
+            "description": "Project to rename and new display name",
             "properties": {
                 "project_id": {
                     "type": "string",