weeek-mcp 0.2.0__py3-none-any.whl

weeek_mcp/__init__.py

@@ -0,0 +1,3 @@
+"""Weeek MCP server: task management (public API) and knowledge base (Playwright)."""
+
+__version__ = "0.2.0"

weeek_mcp/config.py

@@ -0,0 +1,87 @@
+"""Runtime configuration, read from environment variables (and an optional .env file)."""
+
+from __future__ import annotations
+
+import os
+from dataclasses import dataclass
+from pathlib import Path
+
+from dotenv import load_dotenv
+
+# Load .env if present; real environment variables always win.
+load_dotenv()
+
+DEFAULT_API_BASE = "https://api.weeek.net/public/v1"
+DEFAULT_APP_BASE = "https://app.weeek.net"
+# Internal (non-public) API the web app uses for the knowledge base.
+DEFAULT_INTERNAL_API_BASE = "https://api.weeek.net"
+# Hocuspocus server the editors sync document bodies through.
+DEFAULT_COLLAB_BASE = "wss://collabws.weeek.net"
+
+
+def _state_dir() -> Path:
+    base = os.environ.get("XDG_STATE_HOME") or (Path.home() / ".local" / "state")
+    return Path(base) / "weeek-mcp"
+
+
+def _default_state_path() -> Path:
+    """Where the Playwright login session (storageState) is cached."""
+    return _state_dir() / "storage_state.json"
+
+
+def _default_log_path() -> Path | None:
+    """Where diagnostic timing/step logs are written, if enabled.
+
+    Opt-in via WEEEK_DEBUG_LOG=1: MCP hosts commonly discard a locally-run
+    extension's stderr (observed with Claude Desktop: the subprocess's fd 2 is
+    wired to /dev/null), so debug output has to go to a file we control to
+    survive at all — but that shouldn't happen by default for every user.
+    """
+    if os.environ.get("WEEEK_DEBUG_LOG", "").lower() not in ("1", "true"):
+        return None
+    return _state_dir() / "debug.log"
+
+
+@dataclass(frozen=True)
+class Config:
+    # --- Task management (public REST API) ---
+    api_token: str | None
+    api_base: str
+
+    # --- Knowledge base (internal API + Playwright for login) ---
+    app_base: str
+    internal_api_base: str
+    collab_base: str
+    workspace_id: str | None  # auto-detected via /ws when not set
+    email: str | None
+    password: str | None
+    storage_state_path: Path
+    log_path: Path | None
+    headless: bool
+    kb_cache_ttl: int  # seconds to cache the KB document tree for resources/list
+
+    @property
+    def has_api(self) -> bool:
+        return bool(self.api_token)
+
+    @property
+    def has_kb_credentials(self) -> bool:
+        return bool(self.email and self.password)
+
+    @classmethod
+    def from_env(cls) -> "Config":
+        state = os.environ.get("WEEEK_STORAGE_STATE")
+        return cls(
+            api_token=os.environ.get("WEEEK_API_TOKEN"),
+            api_base=os.environ.get("WEEEK_API_BASE", DEFAULT_API_BASE).rstrip("/"),
+            app_base=os.environ.get("WEEEK_APP_BASE", DEFAULT_APP_BASE).rstrip("/"),
+            internal_api_base=os.environ.get("WEEEK_INTERNAL_API_BASE", DEFAULT_INTERNAL_API_BASE).rstrip("/"),
+            collab_base=os.environ.get("WEEEK_COLLAB_BASE", DEFAULT_COLLAB_BASE).rstrip("/"),
+            workspace_id=os.environ.get("WEEEK_WORKSPACE_ID"),
+            email=os.environ.get("WEEEK_EMAIL"),
+            password=os.environ.get("WEEEK_PASSWORD"),
+            storage_state_path=Path(state) if state else _default_state_path(),
+            log_path=_default_log_path(),
+            headless=os.environ.get("WEEEK_HEADLESS", "true").lower() != "false",
+            kb_cache_ttl=int(os.environ.get("WEEEK_KB_CACHE_TTL", "300")),
+        )

weeek_mcp/kb/__init__.py

@@ -0,0 +1,6 @@
+"""Knowledge base access for Weeek via Playwright.
+
+Weeek has no public API for the knowledge base, so this package drives the web app.
+All DOM-specific details live in ``selectors.py`` and are marked as requiring
+validation against the live UI (they cannot be verified without a real login).
+"""