pyscn 1.1.0__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.0.dist-info → pyscn-1.3.0.dist-info}/METADATA

@@ -1,12 +1,12 @@
 Metadata-Version: 2.1
 Name: pyscn
-Version: 1.1.0
+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,12 +17,15 @@ 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
 
 # pyscn - Python Code Quality Analyzer
 
+[![Article](https://img.shields.io/badge/dev.to-Article-0A0A0A?style=flat-square&logo=dev.to)](https://dev.to/daisukeyoda/pyscn-the-code-quality-analyzer-for-vibe-coders-18hk)
 [![PyPI](https://img.shields.io/pypi/v/pyscn?style=flat-square&logo=pypi)](https://pypi.org/project/pyscn/)
 [![Go](https://img.shields.io/badge/Go-1.24+-00ADD8?style=flat-square&logo=go)](https://go.dev/)
 [![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
@@ -54,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
@@ -129,25 +174,19 @@ directory = "reports"
 ## CI/CD Integration
 
 ```yaml
-# .github/workflows/code-quality.yml
-name: Code Quality
-on: [push, pull_request]
-
-jobs:
-  quality-check:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - run: pip install pyscn
-      - name: Quick quality check
-        run: pyscn check .
-      - name: Generate detailed report
-        run: pyscn analyze --json --select complexity,deadcode,deps src/
-      - name: Upload report
-        uses: actions/upload-artifact@v4
-        with:
-          name: code-quality-report
-          path: .pyscn/reports/
+# GitHub Actions
+- uses: actions/checkout@v4
+- run: pipx run pyscn check .    # Fail on quality issues
+
+# Pre-commit hook
+- repo: local
+  hooks:
+    - id: pyscn
+      name: pyscn check
+      entry: pipx run pyscn check .
+      language: system
+      pass_filenames: false
+      types: [python]
 ```
 
 ---

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.0.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.0.dist-info/RECORD

@@ -1,8 +0,0 @@
-pyscn-1.1.0.dist-info/METADATA,sha256=ZvcdbK5o8njCOZcKlsGPLvl3tfbU-9L9MUiib6k8fEI,4674
-pyscn-1.1.0.dist-info/WHEEL,sha256=CYyQE2vHrYPvCU3b7nn-Hl7_xZMO7l2E38d23t5MbRM,104
-pyscn-1.1.0.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=3iTmV-UwrSGoWLtzmL_oKeVJWnLkgfhD3xWIgNq728Q,11624338
-pyscn/main.py,sha256=rtQdBLwQwLWAh8dvynOzilgWd0ayRoh7MaaycpfQcI8,2619
-pyscn-1.1.0.dist-info/RECORD,,