fenix-mcp 2.0.0__py3-none-any.whl → 2.1.0__py3-none-any.whl

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/interface/mcp_server.py

@@ -3,9 +3,10 @@
 
 from __future__ import annotations
 
+import asyncio
 import uuid
-from dataclasses import dataclass
-from typing import Any, Dict, Optional
+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
@@ -15,29 +16,124 @@ class McpServerError(RuntimeError):
     pass
 
 
-@dataclass(slots=True)
+@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": {
-                    "protocolVersion": "2024-11-05",
-                    "capabilities": {"tools": {}, "logging": {}},
-                    "serverInfo": {"name": "fenix_cloud_mcp_py", "version": "0.1.0"},
-                    "sessionId": self.session_id,
-                },
+                "result": result,
             }
 
         if method == "tools/list":

{fenix_mcp-2.0.0.dist-info → fenix_mcp-2.1.0.dist-info}/METADATA

@@ -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.dist-info → fenix_mcp-2.1.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-fenix_mcp/__init__.py,sha256=ewwBzUPQxM4BTmesnfhTvSBnnkCQQPE4nOkAVo-lKYM,180
+fenix_mcp/__init__.py,sha256=Af4xXfl8m_h0nG8Z0emgXTQoXsYRict2ECggE3SGLbY,180
 fenix_mcp/main.py,sha256=iJV-9btNMDJMObvcn7wBQdbLLKjkYCQ1ANGEwHGHlMU,2857
 fenix_mcp/application/presenters.py,sha256=fGME54PdCDhTBhXO-JUB9yLdBHiE1aeXLTC2fCuxnxM,689
 fenix_mcp/application/tool_base.py,sha256=ZCb9g4ij5Hbb0410NEZTYXvPWq-Zkg8ZCsinTa3gCY4,4741
@@ -21,10 +21,10 @@ fenix_mcp/infrastructure/http_client.py,sha256=uJwt_iBGSFa1XPFBeqtm7eznkEm8aZ1v2
 fenix_mcp/infrastructure/logging.py,sha256=bHrWlSi_0HshRe3--BK_5nzUszW-gh37q6jsd0ShS2Y,1371
 fenix_mcp/infrastructure/request_context.py,sha256=hAHXHh-SKizBN7-YgdaRv0JsRYXBdurO2sr9btHPjKI,1101
 fenix_mcp/infrastructure/fenix_api/client.py,sha256=fkXIzo2_Qs4AfnkPX8Z1k-3dwTTJ5wEG-MBCfUZ8Axo,29119
-fenix_mcp/interface/mcp_server.py,sha256=xSIMZwOaEwHLJ1BKy_agdMiep7HFhIgsUhOVz49DsyA,2728
+fenix_mcp/interface/mcp_server.py,sha256=a9zTY-OckfwVZjOF8pwdYyw6C7QKbxyphsu2_p2YfT8,6600
 fenix_mcp/interface/transports.py,sha256=2zJtc-L73zasyiwQoZbvFJ0yT1bggL5WAa7Nm7zID3k,8502
-fenix_mcp-2.0.0.dist-info/METADATA,sha256=6oZbIkzpboBC9i1IzXjedPEo_mSECyo_9tbZ36oHQFA,7714
-fenix_mcp-2.0.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-fenix_mcp-2.0.0.dist-info/entry_points.txt,sha256=o52x_YHBupEd-1Z1GSfUjv3gJrx5_I-EkHhCgt1WBaE,49
-fenix_mcp-2.0.0.dist-info/top_level.txt,sha256=2G1UtKpwjaIGQyE7sRoHecxaGLeuexfjrOUjv9DDKh4,10
-fenix_mcp-2.0.0.dist-info/RECORD,,
+fenix_mcp-2.1.0.dist-info/METADATA,sha256=9Vyu4_sAl8v3n6sWw2mXkycDZZDHOaRDp2N1qO_nGGk,7714
+fenix_mcp-2.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+fenix_mcp-2.1.0.dist-info/entry_points.txt,sha256=o52x_YHBupEd-1Z1GSfUjv3gJrx5_I-EkHhCgt1WBaE,49
+fenix_mcp-2.1.0.dist-info/top_level.txt,sha256=2G1UtKpwjaIGQyE7sRoHecxaGLeuexfjrOUjv9DDKh4,10
+fenix_mcp-2.1.0.dist-info/RECORD,,