fenix-mcp 2.0.0__tar.gz → 2.1.0__tar.gz

{fenix_mcp-2.0.0 → fenix_mcp-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fenix-mcp
-Version: 2.0.0
+Version: 2.1.0
 Summary: Fênix Cloud MCP server implemented in Python
 Author: Fenix Inc
 Requires-Python: >=3.10

{fenix_mcp-2.0.0 → fenix_mcp-2.1.0}/fenix_mcp/__init__.py

@@ -8,4 +8,4 @@ Fênix Cloud MCP Server (Python edition).
 __all__ = ["__version__"]
 
 
-__version__ = "2.0.0"
+__version__ = "2.1.0"

fenix_mcp-2.1.0/fenix_mcp/interface/mcp_server.py

@@ -0,0 +1,183 @@
+# SPDX-License-Identifier: MIT
+"""Lightweight MCP server implementation backed by the tool registry."""
+
+from __future__ import annotations
+
+import asyncio
+import uuid
+from dataclasses import dataclass, field
+from typing import Any, Dict, List, Optional
+
+from fenix_mcp.application.tool_registry import ToolRegistry, build_default_registry
+from fenix_mcp.infrastructure.context import AppContext
+
+
+class McpServerError(RuntimeError):
+    pass
+
+
+@dataclass
+class SimpleMcpServer:
+    context: AppContext
+    registry: ToolRegistry
+    session_id: str
+    _init_instructions: Optional[str] = field(default=None, repr=False)
+
+    def set_personal_access_token(self, token: Optional[str]) -> None:
+        self.context.api_client.update_token(token)
+
+    async def _build_auto_init_instructions(self) -> str:
+        """Load Fenix context automatically on MCP protocol initialize."""
+        api = self.context.api_client
+        logger = self.context.logger
+
+        async def safe_call(func, *args, **kwargs):
+            try:
+                return await asyncio.to_thread(func, *args, **kwargs)
+            except Exception as exc:
+                logger.warning("Auto-init API call failed: %s", exc)
+                return None
+
+        def extract_items(payload: Any, key: str) -> List[Dict[str, Any]]:
+            if payload is None:
+                return []
+            if isinstance(payload, list):
+                return [item for item in payload if isinstance(item, dict)]
+            if isinstance(payload, dict):
+                value = payload.get(key) or payload.get("data")
+                if isinstance(value, list):
+                    return [item for item in value if isinstance(item, dict)]
+            return []
+
+        # Fetch profile, core docs, and user docs in parallel
+        profile_task = safe_call(api.get_profile)
+        core_docs_task = safe_call(api.list_core_documents, return_content=True)
+        user_docs_task = safe_call(api.list_user_core_documents, return_content=True)
+
+        profile, core_docs_raw, user_docs_raw = await asyncio.gather(
+            profile_task, core_docs_task, user_docs_task
+        )
+
+        core_documents = extract_items(core_docs_raw, "coreDocuments")
+        user_documents = extract_items(user_docs_raw, "userCoreDocuments")
+
+        # Build context summary
+        user_info = (profile or {}).get("user") or {}
+        tenant_info = (profile or {}).get("tenant") or {}
+        team_info = (profile or {}).get("team") or {}
+
+        lines = [
+            "# Fenix Cloud Context (Auto-initialized)",
+            "",
+            "## User Context",
+            f"- **User**: {user_info.get('name', 'Unknown')} (`{user_info.get('id', 'N/A')}`)",
+            f"- **Tenant**: {tenant_info.get('name', 'Unknown')} (`{tenant_info.get('id', 'N/A')}`)",
+            f"- **Team**: {team_info.get('name', 'Unknown')} (`{team_info.get('id', 'N/A')}`)",
+        ]
+
+        if core_documents:
+            lines.extend(["", "## Core Documents"])
+            for doc in core_documents:
+                name = doc.get("name", "untitled")
+                content = doc.get("content", "")
+                metadata = doc.get("metadata", "")
+                lines.append(f"\n### {name}")
+                if content:
+                    lines.append(content)
+                if metadata:
+                    lines.append(f"\n**Metadata:**\n{metadata}")
+
+        if user_documents:
+            lines.extend(["", "## User Documents"])
+            for doc in user_documents:
+                name = doc.get("name", "untitled")
+                content = doc.get("content", "")
+                lines.append(f"\n### {name}")
+                if content:
+                    lines.append(content)
+
+        lines.extend(
+            [
+                "",
+                "## Available Tools",
+                "Use `mcp__fenix__knowledge` for work items, docs, sprints, rules.",
+                "Use `mcp__fenix__intelligence` for semantic memory search/save.",
+                "Use `mcp__fenix__productivity` for TODOs.",
+            ]
+        )
+
+        return "\n".join(lines)
+
+    async def handle(self, request: Dict[str, Any]) -> Optional[Dict[str, Any]]:
+        method = request.get("method")
+        request_id = request.get("id")
+
+        if method == "initialize":
+            # Auto-load Fenix context
+            try:
+                self._init_instructions = await self._build_auto_init_instructions()
+            except Exception as exc:
+                self.context.logger.warning("Auto-init failed: %s", exc)
+                self._init_instructions = None
+
+            result = {
+                "protocolVersion": "2024-11-05",
+                "capabilities": {"tools": {}, "logging": {}},
+                "serverInfo": {"name": "fenix_cloud_mcp_py", "version": "0.1.0"},
+                "sessionId": self.session_id,
+            }
+
+            if self._init_instructions:
+                result["instructions"] = self._init_instructions
+
+            return {
+                "jsonrpc": "2.0",
+                "id": request_id,
+                "result": result,
+            }
+
+        if method == "tools/list":
+            return {
+                "jsonrpc": "2.0",
+                "id": request_id,
+                "result": {"tools": self.registry.list_definitions()},
+            }
+
+        if method == "tools/call":
+            params = request.get("params") or {}
+            name = params.get("name")
+            arguments = params.get("arguments") or {}
+
+            if not name:
+                raise McpServerError("Missing tool name in tools/call payload")
+
+            result = await self.registry.execute(name, arguments, self.context)
+
+            return {"jsonrpc": "2.0", "id": request_id, "result": result}
+
+        if method == "notifications/initialized":
+            # Notifications do not require a response
+            return None
+
+        if method == "notifications/cancelled":
+            # Client cancelled a request - no response needed
+            return None
+
+        if method == "logging/setLevel":
+            # Acknowledge log level change request (we don't actually change anything)
+            return {
+                "jsonrpc": "2.0",
+                "id": request_id,
+                "result": {},
+            }
+
+        raise McpServerError(f"Unsupported method: {method}")
+
+
+def build_server(context: AppContext) -> SimpleMcpServer:
+    registry = build_default_registry(context)
+    return SimpleMcpServer(
+        context=context,
+        registry=registry,
+        session_id=str(uuid.uuid4()),
+    )

{fenix_mcp-2.0.0 → fenix_mcp-2.1.0}/fenix_mcp.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fenix-mcp
-Version: 2.0.0
+Version: 2.1.0
 Summary: Fênix Cloud MCP server implemented in Python
 Author: Fenix Inc
 Requires-Python: >=3.10

fenix_mcp-2.0.0/fenix_mcp/interface/mcp_server.py

@@ -1,87 +0,0 @@
-# SPDX-License-Identifier: MIT
-"""Lightweight MCP server implementation backed by the tool registry."""
-
-from __future__ import annotations
-
-import uuid
-from dataclasses import dataclass
-from typing import Any, Dict, Optional
-
-from fenix_mcp.application.tool_registry import ToolRegistry, build_default_registry
-from fenix_mcp.infrastructure.context import AppContext
-
-
-class McpServerError(RuntimeError):
-    pass
-
-
-@dataclass(slots=True)
-class SimpleMcpServer:
-    context: AppContext
-    registry: ToolRegistry
-    session_id: str
-
-    def set_personal_access_token(self, token: Optional[str]) -> None:
-        self.context.api_client.update_token(token)
-
-    async def handle(self, request: Dict[str, Any]) -> Optional[Dict[str, Any]]:
-        method = request.get("method")
-        request_id = request.get("id")
-
-        if method == "initialize":
-            return {
-                "jsonrpc": "2.0",
-                "id": request_id,
-                "result": {
-                    "protocolVersion": "2024-11-05",
-                    "capabilities": {"tools": {}, "logging": {}},
-                    "serverInfo": {"name": "fenix_cloud_mcp_py", "version": "0.1.0"},
-                    "sessionId": self.session_id,
-                },
-            }
-
-        if method == "tools/list":
-            return {
-                "jsonrpc": "2.0",
-                "id": request_id,
-                "result": {"tools": self.registry.list_definitions()},
-            }
-
-        if method == "tools/call":
-            params = request.get("params") or {}
-            name = params.get("name")
-            arguments = params.get("arguments") or {}
-
-            if not name:
-                raise McpServerError("Missing tool name in tools/call payload")
-
-            result = await self.registry.execute(name, arguments, self.context)
-
-            return {"jsonrpc": "2.0", "id": request_id, "result": result}
-
-        if method == "notifications/initialized":
-            # Notifications do not require a response
-            return None
-
-        if method == "notifications/cancelled":
-            # Client cancelled a request - no response needed
-            return None
-
-        if method == "logging/setLevel":
-            # Acknowledge log level change request (we don't actually change anything)
-            return {
-                "jsonrpc": "2.0",
-                "id": request_id,
-                "result": {},
-            }
-
-        raise McpServerError(f"Unsupported method: {method}")
-
-
-def build_server(context: AppContext) -> SimpleMcpServer:
-    registry = build_default_registry(context)
-    return SimpleMcpServer(
-        context=context,
-        registry=registry,
-        session_id=str(uuid.uuid4()),
-    )