scitex 2.15.2__py3-none-any.whl → 2.15.4__py3-none-any.whl

scitex/_mcp_tools/social.py

@@ -1,244 +1,27 @@
 #!/usr/bin/env python3
-# Timestamp: 2026-01-22
-# File: /home/ywatanabe/proj/scitex-code/src/scitex/_mcp_tools/social.py
+# Timestamp: 2026-01-27
+# File: /home/ywatanabe/proj/scitex-python/src/scitex/_mcp_tools/social.py
+"""Social module tools - thin wrapper delegating to socialia package.
 
-"""Social media module tools for FastMCP unified server.
-
-All MCP tools delegate to socialia CLI for reproducibility.
-Each tool returns the CLI command used, enabling human reproduction.
+Single source of truth: socialia MCP tools.
 """
 
 from __future__ import annotations
 
-import json
-import subprocess
-import sys
-from typing import Optional
-
-# Import platform strategies from socialia for MCP tool descriptions
-try:
-    from scitex.social import PLATFORM_STRATEGIES
-except ImportError:
-    try:
-        from socialia import PLATFORM_STRATEGIES
-    except ImportError:
-        PLATFORM_STRATEGIES = """
-## Platform Strategies (install socialia for full guide)
-- twitter: 280 chars, hook first, 1-2 hashtags at end
-- linkedin: 3000 chars, first 2 lines critical, 3-5 hashtags at end
-- reddit: title is key, no hashtags, value first
-- youtube: keyword-rich title <60 chars, 3-5 hashtags in description
-"""
-
-
-def _json(data: dict) -> str:
-    return json.dumps(data, indent=2, default=str)
-
-
-def _run_socialia_cli(*args: str) -> dict:
-    """Run socialia CLI and return structured result."""
-    cmd = [sys.executable, "-m", "socialia", "--json", *args]
-    cli_command = f"socialia {' '.join(args)}"
-
-    try:
-        result = subprocess.run(cmd, capture_output=True, text=True, timeout=60)
-
-        if result.returncode == 0:
-            try:
-                data = json.loads(result.stdout)
-                data["cli_command"] = cli_command
-                return data
-            except json.JSONDecodeError:
-                return {
-                    "success": True,
-                    "output": result.stdout,
-                    "cli_command": cli_command,
-                }
-        else:
-            return {
-                "success": False,
-                "error": result.stderr or result.stdout,
-                "cli_command": cli_command,
-            }
-    except subprocess.TimeoutExpired:
-        return {
-            "success": False,
-            "error": "Command timed out",
-            "cli_command": cli_command,
-        }
-    except Exception as e:
-        return {
-            "success": False,
-            "error": str(e),
-            "cli_command": cli_command,
-        }
-
 
 def register_social_tools(mcp) -> None:
-    """Register social media tools with FastMCP server."""
-
-    @mcp.tool()
-    async def social_post(
-        platform: str,
-        text: str,
-        reply_to: Optional[str] = None,
-        quote: Optional[str] = None,
-        subreddit: Optional[str] = None,
-        title: Optional[str] = None,
-        dry_run: bool = False,
-    ) -> str:
-        """[social] Post content to a social media platform (twitter, linkedin, reddit, youtube).
-
-        PLATFORM STRATEGIES:
-        - twitter: 280 chars. Hook first. 1+ emoji. GitHub URL. 3-5 hashtags at END for SEO
-        - linkedin: 3000 chars. First 2 lines critical. Short paragraphs. Include project links. 3-5 hashtags at END
-        - reddit: Title is key. NO hashtags. Value first, self-promo last. Link in body
-        - youtube: Keyword-rich title <60 chars. Links in description. 3-5 hashtags in description
-
-        BAD: "SciTeX v2.15.0 released! New feature. #Python #AI"
-        GOOD: "Your AI agent can now speak to you remotely.
-
-        Audio relay bridges the gap.
-
-        github.com/user/repo
-
-        #AIAgents #Python"
-        """
-        args = ["post", platform, text]
-
-        if reply_to:
-            args.extend(["--reply-to", reply_to])
-        if quote:
-            args.extend(["--quote", quote])
-        if subreddit and platform == "reddit":
-            args.extend(["--subreddit", subreddit])
-        if title:
-            args.extend(["--title", title])
-        if dry_run:
-            args.append("--dry-run")
-
-        result = _run_socialia_cli(*args)
-        return _json(result)
-
-    @mcp.tool()
-    async def social_delete(
-        platform: str,
-        post_id: str,
-    ) -> str:
-        """[social] Delete a post from a platform (twitter, linkedin, reddit)."""
-        result = _run_socialia_cli("delete", platform, post_id)
-        return _json(result)
-
-    @mcp.tool()
-    async def social_status() -> str:
-        """[social] Check social media configuration and authentication status."""
-        result = _run_socialia_cli("status")
-        return _json(result)
-
-    @mcp.tool()
-    async def social_analytics(
-        platform: str,
-        days: int = 7,
-    ) -> str:
-        """[social] Get analytics for a platform (twitter, youtube, ga)."""
-        result = _run_socialia_cli("analytics", platform, "--days", str(days))
-        return _json(result)
-
-    @mcp.tool()
-    async def social_thread(
-        platform: str,
-        posts: list[str],
-        delay: int = 2,
-        dry_run: bool = False,
-    ) -> str:
-        """[social] Post a thread of connected posts. Posts are list of strings."""
-        import tempfile
-        from pathlib import Path
-
-        # Write posts to temp file (socialia expects file input)
-        thread_content = "\n---\n".join(posts)
-        with tempfile.NamedTemporaryFile(mode="w", suffix=".txt", delete=False) as f:
-            f.write(thread_content)
-            temp_path = f.name
-
-        try:
-            args = ["thread", platform, "--file", temp_path, "--delay", str(delay)]
-            if dry_run:
-                args.append("--dry-run")
-            result = _run_socialia_cli(*args)
-            result["thread_posts"] = posts
-            return _json(result)
-        finally:
-            Path(temp_path).unlink(missing_ok=True)
-
-    @mcp.tool()
-    async def social_check_availability() -> str:
-        """[social] Check if socialia is installed and list available platforms."""
-        try:
-            from scitex.social import (
-                SOCIALIA_AVAILABLE,
-                __socialia_version__,
-            )
-
-            if SOCIALIA_AVAILABLE:
-                return _json(
-                    {
-                        "available": True,
-                        "version": __socialia_version__,
-                        "platforms": ["twitter", "linkedin", "reddit", "youtube"],
-                        "analytics": ["twitter", "youtube", "ga"],
-                    }
-                )
-            else:
-                return _json(
-                    {
-                        "available": False,
-                        "error": "socialia not installed",
-                        "install_command": "pip install socialia",
-                    }
-                )
-        except Exception as e:
-            return _json(
-                {
-                    "available": False,
-                    "error": str(e),
-                }
-            )
-
-    @mcp.tool()
-    async def social_check(
-        platform: Optional[str] = None,
-    ) -> str:
-        """[social] Check platform connection status (v0.1.4+)."""
-        args = ["check"]
-        if platform:
-            args.append(platform)
-        result = _run_socialia_cli(*args)
-        return _json(result)
-
-    @mcp.tool()
-    async def social_feed(
-        platform: Optional[str] = None,
-        limit: int = 10,
-        mentions: bool = False,
-    ) -> str:
-        """[social] Get recent posts from platform feeds (v0.1.4+)."""
-        args = ["feed"]
-        if platform:
-            args.append(platform)
-        args.extend(["--limit", str(limit)])
-        if mentions:
-            args.append("--mentions")
-        result = _run_socialia_cli(*args)
-        return _json(result)
+    """Register social tools by delegating to socialia package."""
+    try:
+        from socialia._mcp.tools import register_all_tools
 
-    @mcp.tool()
-    async def social_me(
-        platform: str,
-    ) -> str:
-        """[social] Get user profile information (v0.1.4+)."""
-        result = _run_socialia_cli("me", platform)
-        return _json(result)
+        # Delegate all MCP tools to socialia
+        register_all_tools(mcp)
+    except ImportError:
+        # Fallback when socialia is not installed
+        @mcp.tool()
+        def social_status() -> str:
+            """[social] Get social media status (not installed)."""
+            return "socialia is required. Install with: pip install socialia"
 
 
 # EOF

scitex/_mcp_tools/writer.py

@@ -1,9 +1,9 @@
 #!/usr/bin/env python3
-# Timestamp: 2026-01-20
+# Timestamp: 2026-01-27
 # File: /home/ywatanabe/proj/scitex-code/src/scitex/_mcp_tools/writer.py
-"""Writer module tools - delegates to scitex-writer package.
+"""Writer module tools - thin wrapper delegating to scitex-writer package.
 
-Provides usage instructions for shell-based compilation workflow.
+Single source of truth: scitex-writer MCP tools.
 """
 
 from __future__ import annotations
@@ -12,26 +12,16 @@ from __future__ import annotations
 def register_writer_tools(mcp) -> None:
     """Register writer tools by delegating to scitex-writer package."""
     try:
-        from scitex_writer._server import INSTRUCTIONS
+        from scitex_writer._mcp.tools import register_all_tools
 
-        _SCITEX_WRITER_AVAILABLE = True
+        # Delegate all MCP tools to scitex-writer
+        register_all_tools(mcp)
     except ImportError:
-        _SCITEX_WRITER_AVAILABLE = False
-        INSTRUCTIONS = None
-
-    if not _SCITEX_WRITER_AVAILABLE:
-
+        # Fallback when scitex-writer is not installed
         @mcp.tool()
         def writer_usage() -> str:
             """[writer] Get usage guide for SciTeX Writer (not installed)."""
             return "scitex-writer is required. Install with: pip install scitex-writer"
 
-        return
-
-    @mcp.tool()
-    def writer_usage() -> str:
-        """[writer] Get usage guide for SciTeX Writer LaTeX manuscript compilation system."""
-        return INSTRUCTIONS
-
 
 # EOF

scitex/canvas/mcp_server.py

@@ -3,8 +3,12 @@
 # File: src/scitex/canvas/mcp_server.py
 # ----------------------------------------
 
-"""
-MCP Server for SciTeX canvas - Multi-panel figure composition.
+"""MCP Server for SciTeX canvas - Multi-panel figure composition.
+
+.. deprecated::
+    This standalone server is deprecated. Use the unified scitex MCP server:
+    CLI: scitex serve
+    Python: from scitex.mcp_server import run_server
 
 Provides tools for:
 - Creating canvas workspaces
@@ -15,6 +19,15 @@ Provides tools for:
 
 from __future__ import annotations
 
+import warnings
+
+warnings.warn(
+    "scitex.canvas.mcp_server is deprecated. Use 'scitex serve' or "
+    "'from scitex.mcp_server import run_server' for the unified MCP server.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
 import asyncio
 
 # Graceful MCP dependency handling
@@ -126,7 +139,7 @@ async def _run_server():
 
 
 def main():
-    """Main entry point for the MCP server."""
+    """Run the MCP server."""
     if not MCP_AVAILABLE:
         import sys
 

scitex/capture/mcp_server.py

@@ -10,11 +10,25 @@ __FILE__ = "./src/scitex/capture/mcp_server.py"
 __DIR__ = os.path.dirname(__FILE__)
 # ----------------------------------------
 
-"""
-MCP Server for SciTeX Capture - Screen Capture for Python
+"""MCP Server for SciTeX Capture - Screen Capture for Python.
+
+.. deprecated::
+    This standalone server is deprecated. Use the unified scitex MCP server:
+    CLI: scitex serve
+    Python: from scitex.mcp_server import run_server
+
 Provides screenshot capture capabilities via Model Context Protocol.
 """
 
+import warnings
+
+warnings.warn(
+    "scitex.capture.mcp_server is deprecated. Use 'scitex serve' or "
+    "'from scitex.mcp_server import run_server' for the unified MCP server.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
 import asyncio
 import base64
 from datetime import datetime

scitex/cli/audio.py

@@ -240,7 +240,28 @@ def stop():
         sys.exit(1)
 
 
-@audio.command()
+@audio.group(invoke_without_command=True)
+@click.pass_context
+def mcp(ctx):
+    """
+    MCP (Model Context Protocol) server operations
+
+    \b
+    Commands:
+      start      - Start the MCP server
+      doctor     - Check MCP server health
+      list-tools - List available MCP tools
+
+    \b
+    Examples:
+      scitex audio mcp start
+      scitex audio mcp start -t http --port 31293
+    """
+    if ctx.invoked_subcommand is None:
+        click.echo(ctx.get_help())
+
+
+@mcp.command()
 @click.option(
     "-t",
     "--transport",
@@ -259,9 +280,9 @@ def stop():
     type=int,
     help="Port for HTTP/SSE transport (default: 31293)",
 )
-def serve(transport, host, port):
+def start(transport, host, port):
     """
-    Run MCP server for remote audio playback
+    Start the MCP server for remote audio playback
 
     Enables remote agents (via SSH) to play audio on local speakers.
 
@@ -273,22 +294,9 @@ def serve(transport, host, port):
 
     \b
     Examples:
-      # Local stdio (Claude Desktop)
-      scitex audio serve
-
-      # HTTP server for remote agents
-      scitex audio serve -t http --port 31293
-
-      # SSE server
-      scitex audio serve -t sse --port 31293
-
-    \b
-    Remote Setup:
-      1. Local:  scitex audio serve -t http --port 31293
-      2. SSH:    Add to ~/.ssh/config:
-                   LocalForward 31293 127.0.0.1:31293
-      3. Remote MCP config:
-                   {"type": "sse", "url": "http://localhost:31293/sse"}
+      scitex audio mcp start
+      scitex audio mcp start -t http --port 31293
+      scitex audio mcp start -t sse --port 31293
     """
     try:
         from scitex.audio.mcp_server import FASTMCP_AVAILABLE, run_server
@@ -320,6 +328,68 @@ def serve(transport, host, port):
         sys.exit(1)
 
 
+@mcp.command()
+def doctor():
+    """
+    Check MCP server health and dependencies
+
+    \b
+    Example:
+      scitex audio mcp doctor
+    """
+    click.secho("Audio MCP Server Health Check", fg="cyan", bold=True)
+    click.echo()
+
+    # Check fastmcp
+    click.echo("Checking FastMCP... ", nl=False)
+    try:
+        from scitex.audio.mcp_server import FASTMCP_AVAILABLE
+
+        if FASTMCP_AVAILABLE:
+            click.secho("OK", fg="green")
+        else:
+            click.secho("NOT INSTALLED", fg="red")
+            click.echo("  Install with: pip install fastmcp")
+    except ImportError:
+        click.secho("FAIL", fg="red")
+
+    # Check audio backends
+    click.echo("Checking audio backends... ", nl=False)
+    try:
+        from scitex.audio import available_backends
+
+        backends = available_backends()
+        if backends:
+            click.secho(f"OK ({', '.join(backends)})", fg="green")
+        else:
+            click.secho("NONE AVAILABLE", fg="yellow")
+    except Exception as e:
+        click.secho(f"FAIL ({e})", fg="red")
+
+
+@mcp.command("list-tools")
+def list_tools():
+    """
+    List available MCP tools
+
+    \b
+    Example:
+      scitex audio mcp list-tools
+    """
+    click.secho("Audio MCP Tools", fg="cyan", bold=True)
+    click.echo()
+    tools = [
+        ("audio_speak", "Convert text to speech and play audio"),
+        ("audio_generate_audio", "Generate audio file without playing"),
+        ("audio_list_backends", "List available TTS backends"),
+        ("audio_list_voices", "List available voices for a backend"),
+        ("audio_play_audio", "Play an audio file"),
+        ("audio_check_audio_status", "Check audio system status"),
+    ]
+    for name, desc in tools:
+        click.echo(f"  {name}: {desc}")
+
+
 @audio.command()
 @click.option(
     "--host",
@@ -359,7 +429,7 @@ def relay(host, port):
     try:
         from scitex.audio.mcp_server import run_relay_server
 
-        click.secho(f"Starting audio relay server", fg="cyan")
+        click.secho("Starting audio relay server", fg="cyan")
         click.echo(f"  Host: {host}")
         click.echo(f"  Port: {port}")
         click.echo()

scitex/cli/capture.py

@@ -314,5 +314,125 @@ def window(handle, output, quality):
         sys.exit(1)
 
 
+@capture.group(invoke_without_command=True)
+@click.pass_context
+def mcp(ctx):
+    """
+    MCP (Model Context Protocol) server operations
+
+    \b
+    Commands:
+      start      - Start the MCP server
+      doctor     - Check MCP server health
+      list-tools - List available MCP tools
+
+    \b
+    Examples:
+      scitex capture mcp start
+      scitex capture mcp list-tools
+    """
+    if ctx.invoked_subcommand is None:
+        click.echo(ctx.get_help())
+
+
+@mcp.command("start")
+@click.option(
+    "-t",
+    "--transport",
+    type=click.Choice(["stdio", "sse", "http"]),
+    default="stdio",
+    help="Transport protocol (default: stdio)",
+)
+@click.option("--host", default="0.0.0.0", help="Host for HTTP/SSE (default: 0.0.0.0)")
+@click.option(
+    "--port", default=8096, type=int, help="Port for HTTP/SSE (default: 8096)"
+)
+def mcp_start(transport, host, port):
+    """
+    Start the capture MCP server
+
+    \b
+    Examples:
+      scitex capture mcp start
+      scitex capture mcp start -t http --port 8096
+    """
+    try:
+        from scitex.capture.mcp_server import main as run_server
+
+        if transport != "stdio":
+            click.secho(f"Starting capture MCP server ({transport})", fg="cyan")
+            click.echo(f"  Host: {host}")
+            click.echo(f"  Port: {port}")
+
+        run_server()
+
+    except ImportError as e:
+        click.secho(f"Error: {e}", fg="red", err=True)
+        click.echo("\nInstall dependencies: pip install fastmcp")
+        sys.exit(1)
+    except Exception as e:
+        click.secho(f"Error: {e}", fg="red", err=True)
+        sys.exit(1)
+
+
+@mcp.command()
+def doctor():
+    """
+    Check MCP server health and dependencies
+
+    \b
+    Example:
+      scitex capture mcp doctor
+    """
+    click.secho("Capture MCP Server Health Check", fg="cyan", bold=True)
+    click.echo()
+
+    click.echo("Checking FastMCP... ", nl=False)
+    try:
+        import fastmcp  # noqa: F401
+
+        click.secho("OK", fg="green")
+    except ImportError:
+        click.secho("NOT INSTALLED", fg="red")
+        click.echo("  Install with: pip install fastmcp")
+
+    click.echo("Checking capture module... ", nl=False)
+    try:
+        from scitex import capture as _  # noqa: F401
+
+        click.secho("OK", fg="green")
+    except ImportError as e:
+        click.secho(f"FAIL ({e})", fg="red")
+
+
+@mcp.command("list-tools")
+def list_tools():
+    """
+    List available MCP tools
+
+    \b
+    Example:
+      scitex capture mcp list-tools
+    """
+    click.secho("Capture MCP Tools", fg="cyan", bold=True)
+    click.echo()
+    tools = [
+        ("capture_capture_screenshot", "Capture screenshot"),
+        ("capture_capture_window", "Capture specific window"),
+        ("capture_start_monitoring", "Start continuous capture"),
+        ("capture_stop_monitoring", "Stop monitoring"),
+        ("capture_get_monitoring_status", "Get monitoring status"),
+        ("capture_analyze_screenshot", "Analyze screenshot for errors"),
+        ("capture_list_recent_screenshots", "List recent screenshots"),
+        ("capture_clear_cache", "Clear screenshot cache"),
+        ("capture_create_gif", "Create animated GIF"),
+        ("capture_list_sessions", "List monitoring sessions"),
+        ("capture_get_info", "Get monitor/window info"),
+        ("capture_list_windows", "List visible windows"),
+    ]
+    for name, desc in tools:
+        click.echo(f"  {name}: {desc}")
+
+
 if __name__ == "__main__":
     capture()