pyscn 1.1.0__py3-none-win_amd64.whl → 1.2.0__py3-none-win_amd64.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.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pyscn
-Version: 1.1.0
+Version: 1.2.0
 Summary: An intelligent Python code quality analyzer with architectural guidance
 Home-page: https://github.com/ludo-technologies/pyscn
 Author: DaisukeYoda
@@ -23,6 +23,7 @@ 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 +55,39 @@ 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.
+
+### Claude Code Setup
+
+```bash
+# Add pyscn MCP server with one command
+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 +163,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.2.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+pyscn/__init__.py,sha256=HRv-Oi427RyttzZalJBUupLHKNFFErBDK49mgM93614,450
+pyscn/__main__.py,sha256=W7pj0bglX-7BEIwWDVdW8yafZYzEsAh7IljY0wzVl6I,127
+pyscn/bin/pyscn-mcp-windows-amd64.exe,sha256=TG6n-uLK1Osr0KQm9hHh-vtzz8nl40sNr2ENq38aYG4,7733248
+pyscn/bin/pyscn-windows-amd64.exe,sha256=H1oGAOcpcMf_ajtO3ar8Dm2J_ZqcBh4T725G3Ln6mLQ,12738048
+pyscn/main.py,sha256=M_vLpulyfAZaM9gtI2HpY3DCFzHRM_ulv9FOdLQUqlE,2714
+pyscn/mcp_main.py,sha256=WVY1sOB9HN1HmIceRgLlFAmvQg99PbrI1Ub-01z-AFQ,2851
+pyscn-1.2.0.dist-info/entry_points.txt,sha256=b3uDJeuGfdioTYIV5vD_OLiCO_BPZ53Bqbe5jOurh4o,78
+pyscn-1.2.0.dist-info/METADATA,sha256=L7W_Cr8Oc-ZrBaKZZB5TSoDnpe09yjQZ27TtnHaODKY,5636
+pyscn-1.2.0.dist-info/WHEEL,sha256=ICN7qb8qrvTQybj9kVPKtBG-ipWcOAsdtIlsfZDPI74,96
+pyscn-1.2.0.dist-info/RECORD,,

{pyscn-1.1.0.dist-info → pyscn-1.2.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/__init__.py,sha256=HRv-Oi427RyttzZalJBUupLHKNFFErBDK49mgM93614,450
-pyscn/__main__.py,sha256=W7pj0bglX-7BEIwWDVdW8yafZYzEsAh7IljY0wzVl6I,127
-pyscn/bin/pyscn-windows-amd64.exe,sha256=CbD_Hcw5je5BsQs6QFllZrM36Vwo4qu_TxRhZP9-QZc,12736512
-pyscn/main.py,sha256=M_vLpulyfAZaM9gtI2HpY3DCFzHRM_ulv9FOdLQUqlE,2714
-pyscn-1.1.0.dist-info/entry_points.txt,sha256=Hq59HuLE4ipwZthGmgvAv7aQF3oiixtCLxivVoNil5w,46
-pyscn-1.1.0.dist-info/METADATA,sha256=jA1Ulrjyi-Gv7TYAM7IaoPg7Z75kg0hCstC7tV-uZwI,4820
-pyscn-1.1.0.dist-info/WHEEL,sha256=ICN7qb8qrvTQybj9kVPKtBG-ipWcOAsdtIlsfZDPI74,96
-pyscn-1.1.0.dist-info/RECORD,,