pylance-mcp-server 1.0.0

package/mcp_server/tracing.py

@@ -0,0 +1,84 @@
+"""
+OpenTelemetry Tracing Configuration
+
+Sets up distributed tracing for the Pylance MCP Server using OpenTelemetry.
+Sends traces to AI Toolkit's local OTLP collector.
+"""
+
+import logging
+from typing import Optional
+from opentelemetry import trace
+from opentelemetry.sdk.trace import TracerProvider
+from opentelemetry.sdk.trace.export import BatchSpanProcessor
+from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter
+from opentelemetry.sdk.resources import Resource
+
+logger = logging.getLogger(__name__)
+
+_tracer: Optional[trace.Tracer] = None
+
+
+def setup_tracing(service_name: str = "pylance-mcp-server", otlp_endpoint: str = "http://localhost:4318") -> trace.Tracer:
+    """
+    Initialize OpenTelemetry tracing with OTLP exporter.
+    
+    Args:
+        service_name: Name of the service for trace identification
+        otlp_endpoint: OTLP HTTP endpoint (default: AI Toolkit's localhost endpoint)
+        
+    Returns:
+        Configured tracer instance
+    """
+    global _tracer
+    
+    if _tracer is not None:
+        logger.info("Tracing already initialized")
+        return _tracer
+    
+    try:
+        # Create resource with service information
+        resource = Resource.create({
+            "service.name": service_name,
+            "service.version": "1.0.0",
+        })
+        
+        # Set up the tracer provider
+        provider = TracerProvider(resource=resource)
+        
+        # Configure OTLP exporter for AI Toolkit
+        otlp_exporter = OTLPSpanExporter(
+            endpoint=f"{otlp_endpoint}/v1/traces",
+            timeout=5,
+        )
+        
+        # Add span processor
+        span_processor = BatchSpanProcessor(otlp_exporter)
+        provider.add_span_processor(span_processor)
+        
+        # Set as global tracer provider
+        trace.set_tracer_provider(provider)
+        
+        # Get tracer instance
+        _tracer = trace.get_tracer(__name__)
+        
+        logger.info(f"OpenTelemetry tracing initialized: {service_name} -> {otlp_endpoint}")
+        return _tracer
+        
+    except Exception as e:
+        logger.error(f"Failed to initialize tracing: {e}")
+        # Return no-op tracer on failure
+        _tracer = trace.get_tracer(__name__)
+        return _tracer
+
+
+def get_tracer() -> trace.Tracer:
+    """
+    Get the configured tracer instance.
+    
+    Returns:
+        Tracer instance (initializes with defaults if not already set up)
+    """
+    global _tracer
+    if _tracer is None:
+        return setup_tracing()
+    return _tracer

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "pylance-mcp-server",
+  "version": "1.0.0",
+  "description": "Pyright/Pylance language server for MCP - Enhanced Python IntelliSense for Claude Desktop",
+  "main": "index.js",
+  "bin": {
+    "pylance-mcp-server": "./bin/pylance-mcp.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/check-python.js && pip install -r requirements.txt",
+    "test": "python quick_test.py"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "pylance",
+    "pyright",
+    "python",
+    "language-server",
+    "claude",
+    "ai",
+    "code-intelligence",
+    "type-checking",
+    "intellisense"
+  ],
+  "author": "JarrodAI",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/JarrodAI/pylance-mcp.git"
+  },
+  "homepage": "https://pylancemcp.com",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "peerDependencies": {
+    "python": ">=3.8"
+  },
+  "dependencies": {
+    "dotenv": "^17.2.3",
+    "node-appwrite": "^14.0.1",
+    "pyright": "^1.1.350"
+  },
+  "files": [
+    "server.py",
+    "mcp_server/",
+    "requirements.txt",
+    "bin/",
+    "scripts/",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/requirements.txt

@@ -0,0 +1,29 @@
+# Core dependencies
+fastmcp>=0.2.0
+pydantic>=2.0.0
+aiofiles>=23.0.0
+uvicorn>=0.24.0
+requests>=2.31.0
+anthropic>=0.40.0
+supabase>=2.3.0
+fastapi>=0.115.0
+
+# OpenTelemetry for tracing
+opentelemetry-api>=1.20.0
+opentelemetry-sdk>=1.20.0
+opentelemetry-exporter-otlp>=1.20.0
+opentelemetry-instrumentation>=0.41b0
+
+# Linting and formatting
+ruff>=0.1.0
+
+# Security and code quality
+bandit>=1.7.5
+radon>=6.0.1
+
+# Development dependencies
+pytest>=7.4.0
+pytest-asyncio>=0.21.0
+black>=23.0.0
+isort>=5.12.0
+mypy>=1.5.0

package/scripts/check-python.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+
+/**
+ * Check Python Installation
+ * 
+ * Verifies that Python 3.8+ is installed before proceeding with package installation.
+ */
+
+const { spawnSync } = require('child_process');
+
+function checkPython() {
+  const pythonCommands = ['python3', 'python', 'py'];
+  
+  for (const cmd of pythonCommands) {
+    try {
+      const result = spawnSync(cmd, ['--version'], {
+        encoding: 'utf-8',
+        stdio: ['pipe', 'pipe', 'pipe']
+      });
+      
+      if (result.status === 0) {
+        const versionOutput = result.stdout || result.stderr || '';
+        const versionMatch = versionOutput.match(/Python (\d+)\.(\d+)/);
+        
+        if (versionMatch) {
+          const major = parseInt(versionMatch[1]);
+          const minor = parseInt(versionMatch[2]);
+          
+          if (major === 3 && minor >= 8) {
+            console.log(`✓ Found ${versionOutput.trim()}`);
+            return true;
+          } else if (major > 3) {
+            console.log(`✓ Found ${versionOutput.trim()}`);
+            return true;
+          } else {
+            console.warn(`⚠ Found ${versionOutput.trim()} but Python 3.8+ is required`);
+          }
+        }
+      }
+    } catch (e) {
+      continue;
+    }
+  }
+  
+  console.error('\n❌ Python 3.8+ is required but not found.');
+  console.error('\nPlease install Python:');
+  console.error('  • Windows/Mac: https://www.python.org/downloads/');
+  console.error('  • Linux: sudo apt install python3 python3-pip');
+  console.error('\nAfter installing Python, run: npm install pylance-mcp-server');
+  
+  process.exit(1);
+}
+
+// Only check if not in CI environment
+if (!process.env.CI && !process.env.SKIP_PYTHON_CHECK) {
+  checkPython();
+}