langprotect-mcp-gateway 1.0.0__py3-none-any.whl → 1.2.0__py3-none-any.whl

langprotect_mcp_gateway-1.2.0.dist-info/METADATA

@@ -0,0 +1,333 @@
+Metadata-Version: 2.4
+Name: langprotect-mcp-gateway
+Version: 1.2.0
+Summary: Security gateway for Model Context Protocol (MCP) to protect AI tool interactions
+Author-email: LangProtect Security Team <security@langprotect.com>
+License: MIT
+Project-URL: Homepage, https://langprotect.com
+Project-URL: Documentation, https://docs.langprotect.com
+Project-URL: Repository, https://github.com/langprotect/mcp-gateway
+Project-URL: Issues, https://github.com/langprotect/mcp-gateway/issues
+Keywords: mcp,security,ai-security,langprotect,model-context-protocol
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Security
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.31.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Dynamic: license-file
+
+# LangProtect MCP Gateway
+
+🛡️ **Security gateway for Model Context Protocol (MCP)** - Protect your AI tool interactions from security threats.
+
+[![PyPI version](https://badge.fury.io/py/langprotect-mcp-gateway.svg)](https://pypi.org/project/langprotect-mcp-gateway/)
+
+## Features
+
+✅ **Automatic Threat Detection** - Scans all MCP requests for security risks  
+✅ **Access Control** - Whitelist/blacklist MCP servers and tools  
+✅ **Full Audit Trail** - Logs all AI interactions for compliance  
+✅ **IDE Support** - Works with VS Code, Cursor, and all MCP-compatible IDEs  
+✅ **Easy Setup** - 30-second installation
+✅ **Fail-Open Design** - Won't block your workflow if backend is unavailable
+
+## Quick Start
+
+### Installation
+
+The gateway runs as a global CLI tool. Choose your platform:
+
+#### Linux (Debian/Ubuntu) - Recommended: pipx
+
+```bash
+# Install pipx (one time)
+sudo apt install pipx -y
+pipx ensurepath
+
+# Install the gateway
+pipx install langprotect-mcp-gateway
+```
+
+#### macOS - Recommended: pipx
+
+```bash
+# Install pipx via Homebrew
+brew install pipx
+pipx ensurepath
+
+# Install the gateway
+pipx install langprotect-mcp-gateway
+```
+
+#### Windows
+
+```bash
+# Option 1: pipx (recommended)
+pip install pipx
+pipx install langprotect-mcp-gateway
+
+# Option 2: User install
+pip install --user langprotect-mcp-gateway
+```
+
+#### Verify Installation
+
+```bash
+which langprotect-gateway   # Should show: ~/.local/bin/langprotect-gateway
+langprotect-gateway --help  # Should show usage info
+```
+
+### VS Code Setup (Recommended - No Wrapper Script!)
+
+Just add this to your `.vscode/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "langprotect-gateway": {
+      "command": "langprotect-gateway",
+      "args": ["--mcp-json-path", "${workspaceFolder}/.vscode/mcp.json"],
+      "env": {
+        "LANGPROTECT_URL": "http://localhost:8000",
+        "LANGPROTECT_EMAIL": "your.email@company.com",
+        "LANGPROTECT_PASSWORD": "your-password"
+      },
+      "servers": {
+        "filesystem": {
+          "command": "npx",
+          "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
+        }
+      }
+    }
+  }
+}
+```
+
+That's it! VS Code will:
+1. Start the gateway with your credentials
+2. Gateway reads the `servers` section and proxies those MCP servers
+3. All tool calls get logged to LangProtect
+
+### Alternative: Wrapper Script Setup
+
+If you prefer using a wrapper script (useful for shared configs):
+
+1. Create a wrapper script (e.g., `langprotect-wrapper.sh`):
+
+```bash
+#!/bin/bash
+export LANGPROTECT_URL="http://localhost:8000"  # Your LangProtect backend
+export LANGPROTECT_EMAIL="your.email@company.com"
+export LANGPROTECT_PASSWORD="your-password"
+export MCP_SERVER_COMMAND="npx"
+export MCP_SERVER_ARGS="-y,@modelcontextprotocol/server-filesystem,/path/to/allowed/dir"
+
+exec langprotect-gateway "$@"
+```
+
+2. Make it executable: `chmod +x langprotect-wrapper.sh`
+
+3. Create `.vscode/mcp.json`:
+
+```json
+{
+  "servers": {
+    "langprotect-filesystem": {
+      "type": "stdio",
+      "command": "/path/to/langprotect-wrapper.sh",
+      "args": []
+    }
+  }
+}
+```
+
+4. Reload VS Code: `Ctrl+Shift+P` → "Developer: Reload Window"
+
+5. Start the server: `Ctrl+Shift+P` → "MCP: List Servers" → Click "Start"
+
+### Cursor Setup
+
+```json
+{
+  "mcpServers": {
+    "langprotect-gateway": {
+      "command": "langprotect-gateway",
+      "args": ["--mcp-json-path", "~/.cursor/mcp.json"],
+      "env": {
+        "LANGPROTECT_URL": "http://localhost:8000",
+        "LANGPROTECT_EMAIL": "your.email@company.com",
+        "LANGPROTECT_PASSWORD": "your-password"
+      },
+      "servers": {
+        "filesystem": {
+          "command": "npx",
+          "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
+        }
+      }
+    }
+  }
+}
+```
+
+### Claude Desktop Setup
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "langprotect-gateway": {
+      "command": "langprotect-gateway",
+      "args": ["--mcp-json-path", "~/Library/Application Support/Claude/claude_desktop_config.json"],
+      "env": {
+        "LANGPROTECT_URL": "http://localhost:8000",
+        "LANGPROTECT_EMAIL": "your.email@company.com",
+        "LANGPROTECT_PASSWORD": "your-password"
+      },
+      "servers": {
+        "filesystem": {
+          "command": "npx",
+          "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
+        }
+      }
+    }
+  }
+}
+```
+
+## How It Works
+
+```
+┌─────────────┐     ┌────────────────────┐     ┌──────────────────┐
+│   VS Code   │────▶│ LangProtect Gateway│────▶│  Filesystem MCP  │
+│  (Copilot)  │     │   (Security Scan)  │     │    Server        │
+└─────────────┘     └────────────────────┘     └──────────────────┘
+                              │
+                              ▼
+                    ┌────────────────────┐
+                    │ LangProtect Backend│
+                    │  (Policy Check)    │
+                    └────────────────────┘
+```
+
+1. **Intercepts** all MCP tool calls from your AI assistant
+2. **Sends** each request to LangProtect backend for security scanning
+3. **Blocks** requests that violate your security policies
+4. **Forwards** allowed requests to the actual MCP server
+5. **Logs** everything for audit trail
+         ↓
+LangProtect Gateway (this package)
+         ↓
+    [Security Scan]
+         ↓
+MCP Servers (filesystem, github, etc.)
+```
+
+Every request is:
+1. Intercepted by the gateway
+2. Scanned for security threats
+3. Logged to LangProtect backend
+4. Forwarded to actual MCP server (if safe)
+5. Response returned to AI
+
+## Dashboard
+
+Monitor all activity at your LangProtect dashboard:
+- View all AI interactions
+- See security threats blocked
+- Track IDE usage
+- Generate compliance reports
+
+## Security
+
+The gateway protects against:
+- 🚫 Sensitive file access (`.env`, SSH keys, etc.)
+- 🚫 Dangerous commands (`rm -rf`, data exfiltration)
+- 🚫 SQL injection patterns
+- 🚫 Hardcoded credentials in suggestions
+- 🚫 Prompt injection attacks
+
+## Troubleshooting
+
+**"externally-managed-environment" error on Linux:**
+- Modern Linux systems protect system Python. Use `pipx` instead:
+  ```bash
+  sudo apt install pipx -y
+  pipx install langprotect-mcp-gateway
+  ```
+
+**Authentication failed:**
+- Check `LANGPROTECT_URL`, `LANGPROTECT_EMAIL`, `LANGPROTECT_PASSWORD` are correct
+- Ensure LangProtect backend is accessible
+
+**Gateway not starting:**
+- Check Python version: `python3 --version` (need 3.8+)
+- Check package installed: `pipx list | grep langprotect`
+- Verify path: `which langprotect-gateway`
+
+**Tools not working:**
+- Check MCP servers are configured under `"servers"` section
+- Restart IDE completely
+
+**Command not found after install:**
+- Run `pipx ensurepath` and restart your terminal
+- Or add `~/.local/bin` to your PATH manually
+
+## For Team Leads
+
+### Quick Team Rollout:
+
+1. **Share credentials** with each team member:
+   ```
+   Email: user@company.com
+   Password: secure-password
+   Server: http://langprotect.company.com:8000
+   ```
+
+2. **Team members install:**
+   ```bash
+   # Linux/macOS
+   sudo apt install pipx -y  # or: brew install pipx
+   pipx install langprotect-mcp-gateway
+   
+   # Configure mcp.json with credentials
+   # Restart IDE
+   ```
+
+3. **Monitor dashboard:** See all team activity in real-time
+
+## Updates
+
+```bash
+# Upgrade with pipx
+pipx upgrade langprotect-mcp-gateway
+
+# Or reinstall specific version
+pipx install langprotect-mcp-gateway==1.1.0 --force
+```
+
+## Support
+
+- **Documentation:** https://docs.langprotect.com
+- **Issues:** https://github.com/langprotect/mcp-gateway/issues
+- **Security:** security@langprotect.com
+
+## License
+
+MIT License - see LICENSE file for details
+
+## Links
+
+- **Homepage:** https://langprotect.com
+- **GitHub:** https://github.com/langprotect/mcp-gateway
+- **Documentation:** https://docs.langprotect.com

langprotect_mcp_gateway-1.2.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+langprotect_mcp_gateway/__init__.py,sha256=zci-MauGyCKv6bMWizCKd-CkrVaAft57ia8kzdTflEY,510
+langprotect_mcp_gateway/gateway.py,sha256=fFliQVSxV8ZCOO4vg0Y466BYlRnKKI1XQlT6P_VHmQ4,17660
+langprotect_mcp_gateway-1.2.0.dist-info/licenses/LICENSE,sha256=aoVP65gKtirVmFPToow5L9IKN4FNjfM6Sejq_5b4cbM,1082
+langprotect_mcp_gateway-1.2.0.dist-info/METADATA,sha256=Nno8XPMpwwvJn7HoQKd27EDxXzXQyaj6by4gxpd_Y7M,9452
+langprotect_mcp_gateway-1.2.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+langprotect_mcp_gateway-1.2.0.dist-info/entry_points.txt,sha256=iM5-7ReYo6_nFF-2DHK1cSi1Nj6wGsG4QqJgcNZ7_GE,69
+langprotect_mcp_gateway-1.2.0.dist-info/top_level.txt,sha256=UjNlX13ma4nwJXuEyi9eMX251c5rooeEao4zajX6ZHk,24
+langprotect_mcp_gateway-1.2.0.dist-info/RECORD,,

langprotect_mcp_gateway-1.0.0.dist-info/METADATA

@@ -1,215 +0,0 @@
-Metadata-Version: 2.4
-Name: langprotect-mcp-gateway
-Version: 1.0.0
-Summary: Security gateway for Model Context Protocol (MCP) to protect AI tool interactions
-Author-email: LangProtect Security Team <security@langprotect.com>
-License: MIT
-Project-URL: Homepage, https://langprotect.com
-Project-URL: Documentation, https://docs.langprotect.com
-Project-URL: Repository, https://github.com/langprotect/mcp-gateway
-Project-URL: Issues, https://github.com/langprotect/mcp-gateway/issues
-Keywords: mcp,security,ai-security,langprotect,model-context-protocol
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Classifier: Topic :: Security
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: requests>=2.31.0
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0.0; extra == "dev"
-Requires-Dist: black>=23.0.0; extra == "dev"
-Requires-Dist: mypy>=1.0.0; extra == "dev"
-Dynamic: license-file
-
-# LangProtect MCP Gateway
-
-🛡️ **Security gateway for Model Context Protocol (MCP)** - Protect your AI tool interactions from security threats.
-
-## Features
-
-✅ **Automatic Threat Detection** - Scans all MCP requests for security risks  
-✅ **Access Control** - Whitelist/blacklist MCP servers and tools  
-✅ **Full Audit Trail** - Logs all AI interactions for compliance  
-✅ **IDE Support** - Works with VS Code, Cursor, and all MCP-compatible IDEs  
-✅ **Easy Setup** - 30-second installation
-
-## Quick Start
-
-### Installation
-
-```bash
-pip install langprotect-mcp-gateway
-```
-
-### Configuration
-
-Create your MCP config file:
-
-**VS Code:** `~/.config/Code/User/mcp.json`  
-**Cursor:** `~/.cursor/mcp.json`
-
-```json
-{
-  "mcpServers": {
-    "langprotect-gateway": {
-      "command": "langprotect-gateway",
-      "env": {
-        "LANGPROTECT_URL": "https://your-langprotect-server.com",
-        "LANGPROTECT_EMAIL": "your.email@company.com",
-        "LANGPROTECT_PASSWORD": "your-password"
-      },
-      "servers": {
-        "filesystem": {
-          "command": "npx",
-          "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
-        }
-      }
-    }
-  }
-}
-```
-
-📝 **Note:** Replace `LANGPROTECT_URL` with your actual server URL (e.g., `https://langprotect.yourcompany.com` or `http://localhost:8000` for local testing).
-
-### Restart Your IDE
-
-**VS Code:** `Ctrl+Shift+P` → "Reload Window"  
-**Cursor:** Close and reopen
-
-Done! 🎉 All your AI tool interactions are now protected.
-
-## What It Does
-
-The LangProtect MCP Gateway intercepts all AI tool interactions and:
-
-1. **Scans for threats** - Detects malicious commands, data exfiltration attempts
-2. **Enforces policies** - Blocks access to sensitive files and dangerous operations
-3. **Logs everything** - Complete audit trail for compliance
-4. **Auto-detects IDE** - Tracks which IDE/tool made each request
-
-## Supported IDEs
-
-- ✅ VS Code (with GitHub Copilot, Codeium, etc.)
-- ✅ Cursor IDE
-- ✅ Windsurf
-- ✅ Zed Editor
-- ✅ Any MCP-compatible IDE
-
-## Environment Variables
-
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `LANGPROTECT_URL` | No | `http://localhost:8000` | Your LangProtect server URL |
-| `LANGPROTECT_EMAIL` | **Yes** | - | Your email address |
-| `LANGPROTECT_PASSWORD` | **Yes** | - | Your password |
-| `DEBUG` | No | `false` | Enable debug logging (true/false) |
-| `MCP_CONFIG_PATH` | No | Auto-detected | Path to servers config (Cursor only) |
-
-⚠️ **Production Setup:** For production deployments, always set `LANGPROTECT_URL` to your actual server:
-
-```json
-"env": {
-  "LANGPROTECT_URL": "https://langprotect.yourcompany.com",
-  "LANGPROTECT_EMAIL": "your.email@company.com",
-  "LANGPROTECT_PASSWORD": "your-password"
-}
-```
-
-The default `http://localhost:8000` is only for local development/testing.
-
-## Architecture
-
-```
-AI Assistant (Copilot, etc.)
-         ↓
-LangProtect Gateway (this package)
-         ↓
-    [Security Scan]
-         ↓
-MCP Servers (filesystem, github, etc.)
-```
-
-Every request is:
-1. Intercepted by the gateway
-2. Scanned for security threats
-3. Logged to LangProtect backend
-4. Forwarded to actual MCP server (if safe)
-5. Response returned to AI
-
-## Dashboard
-
-Monitor all activity at your LangProtect dashboard:
-- View all AI interactions
-- See security threats blocked
-- Track IDE usage
-- Generate compliance reports
-
-## Security
-
-The gateway protects against:
-- 🚫 Sensitive file access (`.env`, SSH keys, etc.)
-- 🚫 Dangerous commands (`rm -rf`, data exfiltration)
-- 🚫 SQL injection patterns
-- 🚫 Hardcoded credentials in suggestions
-- 🚫 Prompt injection attacks
-
-## Troubleshooting
-
-**Authentication failed:**
-- Check `LANGPROTECT_URL`, `LANGPROTECT_EMAIL`, `LANGPROTECT_PASSWORD` are correct
-- Ensure LangProtect backend is accessible
-
-**Gateway not starting:**
-- Check Python version: `python3 --version` (need 3.11+)
-- Check package installed: `pip show langprotect-mcp-gateway`
-
-**Tools not working:**
-- Check MCP servers are configured under `"servers"` section
-- Restart IDE completely
-
-## For Team Leads
-
-### Quick Team Rollout:
-
-1. **Share credentials** with each team member:
-   ```
-   Email: user@company.com
-   Password: secure-password
-   Server: http://langprotect.company.com:8000
-   ```
-
-2. **Team members install:**
-   ```bash
-   pip install langprotect-mcp-gateway
-   # Configure mcp.json with credentials
-   # Restart IDE
-   ```
-
-3. **Monitor dashboard:** See all team activity in real-time
-
-## Updates
-
-```bash
-pip install --upgrade langprotect-mcp-gateway
-```
-
-## Support
-
-- **Documentation:** https://docs.langprotect.com
-- **Issues:** https://github.com/langprotect/mcp-gateway/issues
-- **Security:** security@langprotect.com
-
-## License
-
-MIT License - see LICENSE file for details
-
-## Links
-
-- **Homepage:** https://langprotect.com
-- **GitHub:** https://github.com/langprotect/mcp-gateway
-- **Documentation:** https://docs.langprotect.com

langprotect_mcp_gateway-1.0.0.dist-info/RECORD

@@ -1,8 +0,0 @@
-langprotect_mcp_gateway/__init__.py,sha256=RAVgb8Z_PR2GkmgpAok9G1LCtcSsOarmb01j1pO6asc,510
-langprotect_mcp_gateway/gateway.py,sha256=72D-rGfOU-BRzSGdEnCjVGNP1OoSr9wBCFx7Kjzq1_c,19901
-langprotect_mcp_gateway-1.0.0.dist-info/licenses/LICENSE,sha256=aoVP65gKtirVmFPToow5L9IKN4FNjfM6Sejq_5b4cbM,1082
-langprotect_mcp_gateway-1.0.0.dist-info/METADATA,sha256=s97MVu9Zj70QhxXH-sszyxyvSeYkXdc_ICa9cN4xyw4,6152
-langprotect_mcp_gateway-1.0.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-langprotect_mcp_gateway-1.0.0.dist-info/entry_points.txt,sha256=iM5-7ReYo6_nFF-2DHK1cSi1Nj6wGsG4QqJgcNZ7_GE,69
-langprotect_mcp_gateway-1.0.0.dist-info/top_level.txt,sha256=UjNlX13ma4nwJXuEyi9eMX251c5rooeEao4zajX6ZHk,24
-langprotect_mcp_gateway-1.0.0.dist-info/RECORD,,