pyscn 1.1.1__py3-none-macosx_11_0_arm64.whl → 1.3.0__py3-none-macosx_11_0_arm64.whl

pyscn/mcp_main.py

@@ -0,0 +1,96 @@
+"""
+Entry point for pyscn-mcp MCP server.
+
+This module provides a Python wrapper for the Go-implemented pyscn-mcp binary.
+It automatically detects the platform and executes the appropriate MCP server binary.
+"""
+
+import os
+import sys
+import platform
+from pathlib import Path
+
+
+def get_mcp_binary_path() -> str:
+    """
+    Get the path to the pyscn-mcp binary for the current platform.
+
+    Returns:
+        str: Path to the pyscn-mcp binary.
+
+    Raises:
+        FileNotFoundError: If the binary is not found for the current platform.
+    """
+    system = platform.system().lower()
+    machine = platform.machine().lower()
+
+    # Normalize architecture names
+    if machine in ('x86_64', 'amd64'):
+        machine = 'amd64'
+    elif machine in ('aarch64', 'arm64'):
+        machine = 'arm64'
+    else:
+        raise FileNotFoundError(
+            f"Unsupported architecture: {machine}. "
+            f"Supported architectures: amd64, arm64"
+        )
+
+    # Determine binary name
+    binary_name = f"pyscn-mcp-{system}-{machine}"
+    if system == "windows":
+        binary_name += ".exe"
+
+    # Binary path within the package
+    binary_path = Path(__file__).parent / "bin" / binary_name
+
+    if not binary_path.exists():
+        raise FileNotFoundError(
+            f"pyscn-mcp binary not found for platform {system}-{machine}.\n"
+            f"Expected location: {binary_path}\n"
+            f"Please check that the package was installed correctly."
+        )
+
+    return str(binary_path)
+
+
+def main():
+    """
+    Main entry point for pyscn-mcp MCP server.
+
+    Replaces the current process with the Go-implemented MCP server binary.
+    This ensures proper stdio handling for MCP's JSON-RPC communication.
+    """
+    try:
+        binary_path = get_mcp_binary_path()
+
+        # Prepare arguments
+        args = [binary_path] + sys.argv[1:]
+
+        # Replace the current process with the MCP server binary
+        # This is critical for MCP servers as they need direct stdio access
+        # and proper signal handling without a Python wrapper layer
+        if sys.platform == "win32":
+            # Windows: use os.execv
+            os.execv(binary_path, args)
+        else:
+            # Unix-like: use os.execv
+            os.execv(binary_path, args)
+
+    except FileNotFoundError as e:
+        print(f"Error: {e}", file=sys.stderr)
+        print(
+            f"\nPlatform information:\n"
+            f"  System: {platform.system()}\n"
+            f"  Architecture: {platform.machine()}\n"
+            f"  Python: {platform.python_version()}",
+            file=sys.stderr
+        )
+        sys.exit(1)
+
+    except Exception as e:
+        print(f"Unexpected error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

{pyscn-1.1.1.dist-info → pyscn-1.3.0.dist-info}/METADATA

@@ -1,12 +1,12 @@
 Metadata-Version: 2.1
 Name: pyscn
-Version: 1.1.1
+Version: 1.3.0
 Summary: An intelligent Python code quality analyzer with architectural guidance
 Home-page: https://github.com/ludo-technologies/pyscn
 Author: DaisukeYoda
 Author-email: daisukeyoda@users.noreply.github.com
 License: MIT
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -17,7 +17,9 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Typing :: Typed
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 
@@ -55,6 +57,48 @@ https://github.com/user-attachments/assets/07f48070-c0dd-437b-9621-cb3963f863ff
 
 **100,000+ lines/sec** • Built with Go + tree-sitter
 
+## MCP Integration
+
+Run pyscn analyses straight from AI coding assistants via the Model Context Protocol (MCP). The bundled `pyscn-mcp` server exposes the same tools used in the CLI to Claude Code, Cursor, ChatGPT, and other MCP clients.
+
+### MCP Use Cases
+
+You can interact with pyscn with your AI coding tools:
+
+1. "Analyze the code quality of the app/ directory"
+
+2. "Find duplicate code and help me refactor it"
+
+3. "Show me complex code and help me simplify it"
+
+### Claude Code Setup
+
+```bash
+claude mcp add pyscn-mcp uvx -- pyscn-mcp
+```
+
+### Cursor / Claude Desktop Setup
+
+Add to your MCP settings (`~/.config/claude-desktop/config.json` or Cursor settings):
+
+```json
+{
+  "mcpServers": {
+    "pyscn-mcp": {
+      "command": "uvx",
+      "args": ["pyscn-mcp"],
+      "env": {
+        "PYSCN_CONFIG": "/path/to/.pyscn.toml"
+      }
+    }
+  }
+}
+```
+
+The instructions like "Analyze the code quality" trigger pyscn via MCP.
+
+Dive deeper in `mcp/README.md` for setup walkthroughs and `docs/MCP_INTEGRATION.md` for architecture details.
+
 ## Installation
 
 ```bash

pyscn-1.3.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+pyscn-1.3.0.dist-info/METADATA,sha256=lwp_J2zS1HZb9wFuWUmsOmFqD-y5o80VNHrfw8TM6G4,5743
+pyscn-1.3.0.dist-info/WHEEL,sha256=CYyQE2vHrYPvCU3b7nn-Hl7_xZMO7l2E38d23t5MbRM,104
+pyscn-1.3.0.dist-info/entry_points.txt,sha256=b3uDJeuGfdioTYIV5vD_OLiCO_BPZ53Bqbe5jOurh4o,78
+pyscn/__init__.py,sha256=2899qYVW2M1QljQ7xSvgLeHyf8yjzemZp62di19Baw8,431
+pyscn/__main__.py,sha256=ctBTSh1ps0V8KJLus4fcg5NE2FCF1HEyfXmh1KCw0gs,120
+pyscn/bin/pyscn-darwin-arm64,sha256=HojdouF2MF_CAgtcbQ6zvYZ6qlWjpts3JVNygCUFJ9s,11624306
+pyscn/bin/pyscn-mcp-darwin-arm64,sha256=5BI4rF3muqvdrCMCdN51WaAT2foFstL1LQM86Av6ihs,7105506
+pyscn/main.py,sha256=rtQdBLwQwLWAh8dvynOzilgWd0ayRoh7MaaycpfQcI8,2619
+pyscn/mcp_main.py,sha256=pWy07VEsQzpsuaGyRrNPKUq_4TO538rFk7v7mMkqC1A,2755
+pyscn-1.3.0.dist-info/RECORD,,

{pyscn-1.1.1.dist-info → pyscn-1.3.0.dist-info}/entry_points.txt

@@ -1,2 +1,3 @@
 [console_scripts]
 pyscn = pyscn.__main__:main
+pyscn-mcp = pyscn.mcp_main:main

pyscn-1.1.1.dist-info/RECORD

@@ -1,8 +0,0 @@
-pyscn-1.1.1.dist-info/METADATA,sha256=0COfGoG74nT89qsiYgf8Z-ffDEVBKCk1cRYjcFjQSkE,4612
-pyscn-1.1.1.dist-info/WHEEL,sha256=CYyQE2vHrYPvCU3b7nn-Hl7_xZMO7l2E38d23t5MbRM,104
-pyscn-1.1.1.dist-info/entry_points.txt,sha256=Hq59HuLE4ipwZthGmgvAv7aQF3oiixtCLxivVoNil5w,46
-pyscn/__init__.py,sha256=2899qYVW2M1QljQ7xSvgLeHyf8yjzemZp62di19Baw8,431
-pyscn/__main__.py,sha256=ctBTSh1ps0V8KJLus4fcg5NE2FCF1HEyfXmh1KCw0gs,120
-pyscn/bin/pyscn-darwin-arm64,sha256=HTYn6WjCSdYCTZ4H-wSRnHP3G_ljHnLS290UDuTQsRk,11624338
-pyscn/main.py,sha256=rtQdBLwQwLWAh8dvynOzilgWd0ayRoh7MaaycpfQcI8,2619
-pyscn-1.1.1.dist-info/RECORD,,