langprotect-mcp-gateway 1.2.5__tar.gz → 1.2.6__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: langprotect-mcp-gateway
3
- Version: 1.2.5
3
+ Version: 1.2.6
4
4
  Summary: Security gateway for Model Context Protocol (MCP) to protect AI tool interactions
5
5
  Author-email: LangProtect Security Team <security@langprotect.com>
6
6
  License: MIT
@@ -43,123 +43,49 @@ Dynamic: license-file
43
43
 
44
44
  ## Quick Start
45
45
 
46
- ### Installation
46
+ ### 1. Installation
47
47
 
48
- The gateway runs as a global CLI tool. Choose your platform:
49
-
50
- #### Linux (Debian/Ubuntu) - Recommended: pipx
48
+ The gateway runs as a global CLI tool. We recommend using `pipx` to manage the installation.
51
49
 
52
50
  ```bash
53
- # Install pipx (one time)
54
- sudo apt install pipx -y
55
- pipx ensurepath
56
-
57
- # Install the gateway
51
+ # Recommended: Install via pipx
58
52
  pipx install langprotect-mcp-gateway
59
53
  ```
60
54
 
61
- #### macOS - Recommended: pipx
62
-
63
- ```bash
64
- # Install pipx via Homebrew
65
- brew install pipx
66
- pipx ensurepath
67
-
68
- # Install the gateway
69
- pipx install langprotect-mcp-gateway
70
- ```
71
-
72
- #### Windows
73
-
74
- ```bash
75
- # Option 1: pipx (recommended)
76
- pip install pipx
77
- pipx install langprotect-mcp-gateway
78
-
79
- # Option 2: User install
80
- pip install --user langprotect-mcp-gateway
81
- ```
55
+ ### 2. Automatic Setup (Recommended) 🚀
82
56
 
83
- #### Verify Installation
84
-
85
- ```bash
86
- which langprotect-gateway # Should show: ~/.local/bin/langprotect-gateway
87
- langprotect-gateway --help # Should show usage info
88
- ```
89
-
90
- #### Automatic Setup (Recommended)
91
-
92
- Run the setup command to automatically configure VS Code:
57
+ Run our automated setup command to configure VS Code, Cursor, or Claude Desktop for all workspaces:
93
58
 
94
59
  ```bash
95
60
  langprotect-gateway-setup
96
61
  ```
97
62
 
98
63
  This will:
99
- - ✅ Create a global wrapper script
64
+ - ✅ Create a global wrapper script at `~/.local/bin/langprotect-mcp-wrapper.sh`
100
65
  - ✅ Configure VS Code for global visibility in ALL workspaces
101
- - ✅ Sync with Claude Desktop config for high compatibility
102
- - ✅ Enable auto-start
66
+ - ✅ Enable auto-start for seamless protection
67
+
68
+ ### 3. Configure Your Credentials
103
69
 
104
- Then edit the wrapper script to add your credentials:
70
+ Edit the generated wrapper script to add your LangProtect email and password:
105
71
 
106
72
  ```bash
107
73
  # Linux/macOS
108
74
  nano ~/.local/bin/langprotect-mcp-wrapper.sh
109
75
 
110
76
  # Update these lines:
111
- export LANGPROTECT_URL="http://localhost:8000"
77
+ export LANGPROTECT_URL="https://your-backend.com" # e.g. http://localhost:8000
112
78
  export LANGPROTECT_EMAIL="your.email@company.com"
113
79
  export LANGPROTECT_PASSWORD="your-password"
114
80
  ```
115
81
 
116
- Reload VS Code and you're done! LangProtect will protect all your workspaces.
117
-
118
- ### VS Code Setup (Recommended - No Wrapper Script!)
119
-
120
- **Step 1:** Add this to your `.vscode/mcp.json`:
121
-
122
- ```json
123
- {
124
- "servers": {
125
- "langprotect-gateway": {
126
- "type": "stdio",
127
- "command": "langprotect-gateway",
128
- "args": ["--mcp-json-path", "${workspaceFolder}/.vscode/mcp.json"],
129
- "env": {
130
- "LANGPROTECT_URL": "http://localhost:8000",
131
- "LANGPROTECT_EMAIL": "your.email@company.com",
132
- "LANGPROTECT_PASSWORD": "your-password"
133
- },
134
- "servers": {
135
- "filesystem": {
136
- "command": "npx",
137
- "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
138
- }
139
- }
140
- }
141
- }
142
- }
143
- ```
144
-
145
- **Step 2 (Optional):** Enable auto-start in `.vscode/settings.json`:
146
-
147
- ```json
148
- {
149
- "chat.mcp.autostart": "newAndOutdated"
150
- }
151
- ```
152
-
153
- This makes VS Code automatically start the gateway when you open the workspace!
82
+ Reload VS Code and you're done! LangProtect will now protect all your workspaces.
154
83
 
155
- That's it! VS Code will:
156
- 1. Start the gateway with your credentials (automatically if autostart is enabled)
157
- 2. Gateway reads the `servers` section and proxies those MCP servers
158
- 3. All tool calls get logged to LangProtect
84
+ ---
159
85
 
160
- ### Alternative: Wrapper Script Setup
86
+ ## 🏗️ Manual Setup (Per-Workspace)
161
87
 
162
- If you prefer using a wrapper script (useful for shared configs):
88
+ If you prefer to enable LangProtect only for a specific project, you can use a local `.vscode/mcp.json` file.
163
89
 
164
90
  1. Create a wrapper script (e.g., `langprotect-wrapper.sh`):
165
91
 
@@ -15,123 +15,49 @@
15
15
 
16
16
  ## Quick Start
17
17
 
18
- ### Installation
18
+ ### 1. Installation
19
19
 
20
- The gateway runs as a global CLI tool. Choose your platform:
21
-
22
- #### Linux (Debian/Ubuntu) - Recommended: pipx
20
+ The gateway runs as a global CLI tool. We recommend using `pipx` to manage the installation.
23
21
 
24
22
  ```bash
25
- # Install pipx (one time)
26
- sudo apt install pipx -y
27
- pipx ensurepath
28
-
29
- # Install the gateway
23
+ # Recommended: Install via pipx
30
24
  pipx install langprotect-mcp-gateway
31
25
  ```
32
26
 
33
- #### macOS - Recommended: pipx
34
-
35
- ```bash
36
- # Install pipx via Homebrew
37
- brew install pipx
38
- pipx ensurepath
39
-
40
- # Install the gateway
41
- pipx install langprotect-mcp-gateway
42
- ```
43
-
44
- #### Windows
45
-
46
- ```bash
47
- # Option 1: pipx (recommended)
48
- pip install pipx
49
- pipx install langprotect-mcp-gateway
50
-
51
- # Option 2: User install
52
- pip install --user langprotect-mcp-gateway
53
- ```
27
+ ### 2. Automatic Setup (Recommended) 🚀
54
28
 
55
- #### Verify Installation
56
-
57
- ```bash
58
- which langprotect-gateway # Should show: ~/.local/bin/langprotect-gateway
59
- langprotect-gateway --help # Should show usage info
60
- ```
61
-
62
- #### Automatic Setup (Recommended)
63
-
64
- Run the setup command to automatically configure VS Code:
29
+ Run our automated setup command to configure VS Code, Cursor, or Claude Desktop for all workspaces:
65
30
 
66
31
  ```bash
67
32
  langprotect-gateway-setup
68
33
  ```
69
34
 
70
35
  This will:
71
- - ✅ Create a global wrapper script
36
+ - ✅ Create a global wrapper script at `~/.local/bin/langprotect-mcp-wrapper.sh`
72
37
  - ✅ Configure VS Code for global visibility in ALL workspaces
73
- - ✅ Sync with Claude Desktop config for high compatibility
74
- - ✅ Enable auto-start
38
+ - ✅ Enable auto-start for seamless protection
39
+
40
+ ### 3. Configure Your Credentials
75
41
 
76
- Then edit the wrapper script to add your credentials:
42
+ Edit the generated wrapper script to add your LangProtect email and password:
77
43
 
78
44
  ```bash
79
45
  # Linux/macOS
80
46
  nano ~/.local/bin/langprotect-mcp-wrapper.sh
81
47
 
82
48
  # Update these lines:
83
- export LANGPROTECT_URL="http://localhost:8000"
49
+ export LANGPROTECT_URL="https://your-backend.com" # e.g. http://localhost:8000
84
50
  export LANGPROTECT_EMAIL="your.email@company.com"
85
51
  export LANGPROTECT_PASSWORD="your-password"
86
52
  ```
87
53
 
88
- Reload VS Code and you're done! LangProtect will protect all your workspaces.
89
-
90
- ### VS Code Setup (Recommended - No Wrapper Script!)
91
-
92
- **Step 1:** Add this to your `.vscode/mcp.json`:
93
-
94
- ```json
95
- {
96
- "servers": {
97
- "langprotect-gateway": {
98
- "type": "stdio",
99
- "command": "langprotect-gateway",
100
- "args": ["--mcp-json-path", "${workspaceFolder}/.vscode/mcp.json"],
101
- "env": {
102
- "LANGPROTECT_URL": "http://localhost:8000",
103
- "LANGPROTECT_EMAIL": "your.email@company.com",
104
- "LANGPROTECT_PASSWORD": "your-password"
105
- },
106
- "servers": {
107
- "filesystem": {
108
- "command": "npx",
109
- "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
110
- }
111
- }
112
- }
113
- }
114
- }
115
- ```
116
-
117
- **Step 2 (Optional):** Enable auto-start in `.vscode/settings.json`:
118
-
119
- ```json
120
- {
121
- "chat.mcp.autostart": "newAndOutdated"
122
- }
123
- ```
124
-
125
- This makes VS Code automatically start the gateway when you open the workspace!
54
+ Reload VS Code and you're done! LangProtect will now protect all your workspaces.
126
55
 
127
- That's it! VS Code will:
128
- 1. Start the gateway with your credentials (automatically if autostart is enabled)
129
- 2. Gateway reads the `servers` section and proxies those MCP servers
130
- 3. All tool calls get logged to LangProtect
56
+ ---
131
57
 
132
- ### Alternative: Wrapper Script Setup
58
+ ## 🏗️ Manual Setup (Per-Workspace)
133
59
 
134
- If you prefer using a wrapper script (useful for shared configs):
60
+ If you prefer to enable LangProtect only for a specific project, you can use a local `.vscode/mcp.json` file.
135
61
 
136
62
  1. Create a wrapper script (e.g., `langprotect-wrapper.sh`):
137
63
 
@@ -129,8 +129,16 @@ class LangProtectAuth:
129
129
  def scan(self, tool_name: str, arguments: Dict, server_name: str) -> Dict:
130
130
  self.ensure_token()
131
131
  try:
132
- payload = {'prompt': json.dumps({'tool': tool_name, 'arguments': arguments, 'server': server_name}), 'client_ip': '127.0.0.1', 'user_agent': f'LangProtect-MCP-Gateway/1.0 (server={server_name})', 'source': 'mcp-gateway'}
133
- response = requests.post(f"{self.url}/v1/group-logs/scan", json=payload, headers={'Authorization': f'Bearer {self.jwt_token}', 'Content-Type': 'application/json'}, timeout=5)
132
+ # Use MCP-specific endpoint with proper payload structure
133
+ payload = {
134
+ 'method': 'tools/call',
135
+ 'params': {'name': tool_name, 'arguments': arguments},
136
+ 'server_url': server_name,
137
+ 'agent_id': 'langprotect-gateway',
138
+ 'client_ip': '127.0.0.1',
139
+ 'user_agent': f'LangProtect-MCP-Gateway/1.0 (server={server_name})'
140
+ }
141
+ response = requests.post(f"{self.url}/v1/group-logs/mcp/scan", json=payload, headers={'Authorization': f'Bearer {self.jwt_token}', 'Content-Type': 'application/json'}, timeout=5)
134
142
  if response.status_code != 200:
135
143
  logger.warning(f"Backend returned {response.status_code}, allowing request (fail-open)")
136
144
  return {'status': 'allowed', 'error': f'Backend error: {response.status_code}'}
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: langprotect-mcp-gateway
3
- Version: 1.2.5
3
+ Version: 1.2.6
4
4
  Summary: Security gateway for Model Context Protocol (MCP) to protect AI tool interactions
5
5
  Author-email: LangProtect Security Team <security@langprotect.com>
6
6
  License: MIT
@@ -43,123 +43,49 @@ Dynamic: license-file
43
43
 
44
44
  ## Quick Start
45
45
 
46
- ### Installation
46
+ ### 1. Installation
47
47
 
48
- The gateway runs as a global CLI tool. Choose your platform:
49
-
50
- #### Linux (Debian/Ubuntu) - Recommended: pipx
48
+ The gateway runs as a global CLI tool. We recommend using `pipx` to manage the installation.
51
49
 
52
50
  ```bash
53
- # Install pipx (one time)
54
- sudo apt install pipx -y
55
- pipx ensurepath
56
-
57
- # Install the gateway
51
+ # Recommended: Install via pipx
58
52
  pipx install langprotect-mcp-gateway
59
53
  ```
60
54
 
61
- #### macOS - Recommended: pipx
62
-
63
- ```bash
64
- # Install pipx via Homebrew
65
- brew install pipx
66
- pipx ensurepath
67
-
68
- # Install the gateway
69
- pipx install langprotect-mcp-gateway
70
- ```
71
-
72
- #### Windows
73
-
74
- ```bash
75
- # Option 1: pipx (recommended)
76
- pip install pipx
77
- pipx install langprotect-mcp-gateway
78
-
79
- # Option 2: User install
80
- pip install --user langprotect-mcp-gateway
81
- ```
55
+ ### 2. Automatic Setup (Recommended) 🚀
82
56
 
83
- #### Verify Installation
84
-
85
- ```bash
86
- which langprotect-gateway # Should show: ~/.local/bin/langprotect-gateway
87
- langprotect-gateway --help # Should show usage info
88
- ```
89
-
90
- #### Automatic Setup (Recommended)
91
-
92
- Run the setup command to automatically configure VS Code:
57
+ Run our automated setup command to configure VS Code, Cursor, or Claude Desktop for all workspaces:
93
58
 
94
59
  ```bash
95
60
  langprotect-gateway-setup
96
61
  ```
97
62
 
98
63
  This will:
99
- - ✅ Create a global wrapper script
64
+ - ✅ Create a global wrapper script at `~/.local/bin/langprotect-mcp-wrapper.sh`
100
65
  - ✅ Configure VS Code for global visibility in ALL workspaces
101
- - ✅ Sync with Claude Desktop config for high compatibility
102
- - ✅ Enable auto-start
66
+ - ✅ Enable auto-start for seamless protection
67
+
68
+ ### 3. Configure Your Credentials
103
69
 
104
- Then edit the wrapper script to add your credentials:
70
+ Edit the generated wrapper script to add your LangProtect email and password:
105
71
 
106
72
  ```bash
107
73
  # Linux/macOS
108
74
  nano ~/.local/bin/langprotect-mcp-wrapper.sh
109
75
 
110
76
  # Update these lines:
111
- export LANGPROTECT_URL="http://localhost:8000"
77
+ export LANGPROTECT_URL="https://your-backend.com" # e.g. http://localhost:8000
112
78
  export LANGPROTECT_EMAIL="your.email@company.com"
113
79
  export LANGPROTECT_PASSWORD="your-password"
114
80
  ```
115
81
 
116
- Reload VS Code and you're done! LangProtect will protect all your workspaces.
117
-
118
- ### VS Code Setup (Recommended - No Wrapper Script!)
119
-
120
- **Step 1:** Add this to your `.vscode/mcp.json`:
121
-
122
- ```json
123
- {
124
- "servers": {
125
- "langprotect-gateway": {
126
- "type": "stdio",
127
- "command": "langprotect-gateway",
128
- "args": ["--mcp-json-path", "${workspaceFolder}/.vscode/mcp.json"],
129
- "env": {
130
- "LANGPROTECT_URL": "http://localhost:8000",
131
- "LANGPROTECT_EMAIL": "your.email@company.com",
132
- "LANGPROTECT_PASSWORD": "your-password"
133
- },
134
- "servers": {
135
- "filesystem": {
136
- "command": "npx",
137
- "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
138
- }
139
- }
140
- }
141
- }
142
- }
143
- ```
144
-
145
- **Step 2 (Optional):** Enable auto-start in `.vscode/settings.json`:
146
-
147
- ```json
148
- {
149
- "chat.mcp.autostart": "newAndOutdated"
150
- }
151
- ```
152
-
153
- This makes VS Code automatically start the gateway when you open the workspace!
82
+ Reload VS Code and you're done! LangProtect will now protect all your workspaces.
154
83
 
155
- That's it! VS Code will:
156
- 1. Start the gateway with your credentials (automatically if autostart is enabled)
157
- 2. Gateway reads the `servers` section and proxies those MCP servers
158
- 3. All tool calls get logged to LangProtect
84
+ ---
159
85
 
160
- ### Alternative: Wrapper Script Setup
86
+ ## 🏗️ Manual Setup (Per-Workspace)
161
87
 
162
- If you prefer using a wrapper script (useful for shared configs):
88
+ If you prefer to enable LangProtect only for a specific project, you can use a local `.vscode/mcp.json` file.
163
89
 
164
90
  1. Create a wrapper script (e.g., `langprotect-wrapper.sh`):
165
91
 
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "langprotect-mcp-gateway"
7
- version = "1.2.5"
7
+ version = "1.2.6"
8
8
  description = "Security gateway for Model Context Protocol (MCP) to protect AI tool interactions"
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.8"