multicloud-security-mcp 1.0.0__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.
@@ -0,0 +1,139 @@
1
+ # Logs
2
+ logs
3
+ *.log
4
+ npm-debug.log*
5
+ yarn-debug.log*
6
+ yarn-error.log*
7
+ lerna-debug.log*
8
+ .env.example
9
+ # Diagnostic reports (https://nodejs.org/api/report.html)
10
+ report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
11
+
12
+ # Runtime data
13
+ pids
14
+ *.pid
15
+ *.seed
16
+ *.pid.lock
17
+
18
+ # Directory for instrumented libs generated by jscoverage/JSCover
19
+ lib-cov
20
+
21
+ # Coverage directory used by tools like istanbul
22
+ coverage
23
+ *.lcov
24
+
25
+ # nyc test coverage
26
+ .nyc_output
27
+
28
+ # Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
29
+ .grunt
30
+
31
+ # Bower dependency directory (https://bower.io/)
32
+ bower_components
33
+
34
+ # node-waf configuration
35
+ .lock-wscript
36
+
37
+ # Compiled binary addons (https://nodejs.org/api/addons.html)
38
+ build/Release
39
+
40
+ # Dependency directories
41
+ node_modules/
42
+ jspm_packages/
43
+
44
+ # Snowpack dependency directory (https://snowpack.dev/)
45
+ web_modules/
46
+
47
+ # TypeScript cache
48
+ *.tsbuildinfo
49
+
50
+ # Optional npm cache directory
51
+ .npm
52
+ .npmignore
53
+ # Optional eslint cache
54
+ .eslintcache
55
+
56
+ # Optional stylelint cache
57
+ .stylelintcache
58
+
59
+ # Optional REPL history
60
+ .node_repl_history
61
+
62
+ # Output of 'npm pack'
63
+ *.tgz
64
+
65
+ # Yarn Integrity file
66
+ .yarn-integrity
67
+
68
+ # dotenv environment variable files
69
+ .env
70
+ .env.*
71
+ !.env.example
72
+
73
+ # parcel-bundler cache (https://parceljs.org/)
74
+ .cache
75
+ .parcel-cache
76
+
77
+ # Next.js build output
78
+ .next
79
+ out
80
+
81
+ # Nuxt.js build / generate output
82
+ .nuxt
83
+ dist
84
+
85
+ # Gatsby files
86
+ .cache/
87
+ # Comment in the public line in if your project uses Gatsby and not Next.js
88
+ # https://nextjs.org/blog/next-9-1#public-directory-support
89
+ # public
90
+
91
+ # vuepress build output
92
+ .vuepress/dist
93
+
94
+ # vuepress v2.x temp and cache directory
95
+ .temp
96
+ .cache
97
+
98
+ # Sveltekit cache directory
99
+ .svelte-kit/
100
+
101
+ # vitepress build output
102
+ **/.vitepress/dist
103
+
104
+ # vitepress cache directory
105
+ **/.vitepress/cache
106
+
107
+ # Docusaurus cache and generated files
108
+ .docusaurus
109
+
110
+ # Serverless directories
111
+ .serverless/
112
+
113
+ # FuseBox cache
114
+ .fusebox/
115
+
116
+ # DynamoDB Local files
117
+ .dynamodb/
118
+
119
+ # Firebase cache directory
120
+ .firebase/
121
+
122
+ # TernJS port file
123
+ .tern-port
124
+
125
+ # Stores VSCode versions used for testing VSCode extensions
126
+ .vscode-test
127
+
128
+ # yarn v3
129
+ .pnp.*
130
+ .yarn/*
131
+ !.yarn/patches
132
+ !.yarn/plugins
133
+ !.yarn/releases
134
+ !.yarn/sdks
135
+ !.yarn/versions
136
+
137
+ # Vite logs files
138
+ vite.config.js.timestamp-*
139
+ vite.config.ts.timestamp-*
@@ -0,0 +1,155 @@
1
+ Metadata-Version: 2.5
2
+ Name: multicloud-security-mcp
3
+ Version: 1.0.0
4
+ Summary: Multi-Cloud Security MCP Server — unified security visibility across AWS, Azure, and GCP for AI agents and Claude Desktop
5
+ Project-URL: Homepage, https://github.com/skmahe1077/multicloud-security-mcp
6
+ Project-URL: Repository, https://github.com/skmahe1077/multicloud-security-mcp
7
+ Project-URL: Issues, https://github.com/skmahe1077/multicloud-security-mcp/issues
8
+ Author: Mahendran Selvakumar
9
+ License-Expression: MIT
10
+ Keywords: ai-agent,aws,azure,claude,cloud-security,devsecops,gcp,mcp,model-context-protocol,multicloud,security,siem
11
+ Classifier: Development Status :: 4 - Beta
12
+ Classifier: Intended Audience :: Developers
13
+ Classifier: Intended Audience :: System Administrators
14
+ Classifier: License :: OSI Approved :: MIT License
15
+ Classifier: Operating System :: OS Independent
16
+ Classifier: Programming Language :: Python :: 3
17
+ Classifier: Programming Language :: Python :: 3.10
18
+ Classifier: Programming Language :: Python :: 3.11
19
+ Classifier: Programming Language :: Python :: 3.12
20
+ Classifier: Programming Language :: Python :: 3.13
21
+ Classifier: Topic :: Security
22
+ Classifier: Topic :: System :: Systems Administration
23
+ Requires-Python: >=3.10
24
+ Description-Content-Type: text/markdown
25
+
26
+ # multicloud-security-mcp
27
+
28
+ [![PyPI version](https://img.shields.io/pypi/v/multicloud-security-mcp.svg)](https://pypi.org/project/multicloud-security-mcp/)
29
+ [![npm version](https://img.shields.io/npm/v/multicloud-security-mcp.svg)](https://www.npmjs.com/package/multicloud-security-mcp)
30
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
31
+
32
+ A production-ready **Model Context Protocol (MCP)** server providing unified security visibility across **AWS**, **Azure**, and **GCP**. Designed for AI agents and Claude Desktop.
33
+
34
+ **46 security tools** spanning threat detection, vulnerability management, IAM security, data protection, network security, key/secret management, container security, and compliance — all exposed through a single MCP server.
35
+
36
+ ## Install
37
+
38
+ ```bash
39
+ # pip
40
+ pip install multicloud-security-mcp
41
+
42
+ # uv
43
+ uv pip install multicloud-security-mcp
44
+
45
+ # pipx (isolated global install)
46
+ pipx install multicloud-security-mcp
47
+ ```
48
+
49
+ > **Prerequisite:** Node.js 20+ must be available on PATH. Install from [nodejs.org](https://nodejs.org) if needed.
50
+
51
+ ## Quick Start
52
+
53
+ ```bash
54
+ # Run the MCP server
55
+ multicloud-security-mcp
56
+
57
+ # Or via python module
58
+ python -m multicloud_security_mcp
59
+ ```
60
+
61
+ ## Claude Desktop Configuration
62
+
63
+ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
64
+
65
+ ### Using pip installation
66
+
67
+ ```json
68
+ {
69
+ "mcpServers": {
70
+ "multicloud-security": {
71
+ "command": "multicloud-security-mcp",
72
+ "env": {
73
+ "AWS_PROFILE": "security-audit",
74
+ "AZURE_CLIENT_ID": "your-app-id",
75
+ "AZURE_CLIENT_SECRET": "your-secret",
76
+ "AZURE_TENANT_ID": "your-tenant",
77
+ "AZURE_SUBSCRIPTION_ID": "your-sub",
78
+ "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/sa.json",
79
+ "GCP_PROJECT_ID": "your-project"
80
+ }
81
+ }
82
+ }
83
+ }
84
+ ```
85
+
86
+ ### Using uvx (no install needed)
87
+
88
+ ```json
89
+ {
90
+ "mcpServers": {
91
+ "multicloud-security": {
92
+ "command": "uvx",
93
+ "args": ["multicloud-security-mcp"],
94
+ "env": {
95
+ "AWS_PROFILE": "security-audit"
96
+ }
97
+ }
98
+ }
99
+ }
100
+ ```
101
+
102
+ ## What's Included
103
+
104
+ ### AWS (15 tools)
105
+ SecurityHub, GuardDuty, Inspector, IAM Analyzer, Macie, CloudTrail, Detective, Config Rules, WAF, Shield, Network Firewall, Secrets Manager, KMS, ECR, SSM Patch
106
+
107
+ ### Azure (13 tools)
108
+ Defender, Sentinel, Entra ID Protection, Purview DLP, Policy, Key Vault, Firewall, DDoS Protection, Container Registry, Network Watcher, Defender for Endpoint, App Service, DevOps Security
109
+
110
+ ### GCP (13 tools)
111
+ Security Command Center, Chronicle, IAM Recommender, Cloud DLP, Cloud Armor, Binary Authorization, Artifact Registry, VPC Service Controls, Cloud KMS, Secret Manager, Asset Inventory, Access Transparency, Audit Logs
112
+
113
+ ### Cross-Cloud (5 tools)
114
+ Critical Findings aggregation, Compliance Dashboard, IAM Blast Radius analysis, SIEM Correlation, Secret Rotation Audit
115
+
116
+ ## Cloud Authentication
117
+
118
+ Set environment variables for each cloud you want to use:
119
+
120
+ ```bash
121
+ # AWS
122
+ export AWS_ACCESS_KEY_ID=...
123
+ export AWS_SECRET_ACCESS_KEY=...
124
+ export AWS_DEFAULT_REGION=eu-west-1
125
+
126
+ # Azure
127
+ export AZURE_CLIENT_ID=...
128
+ export AZURE_CLIENT_SECRET=...
129
+ export AZURE_TENANT_ID=...
130
+ export AZURE_SUBSCRIPTION_ID=...
131
+
132
+ # GCP
133
+ export GOOGLE_APPLICATION_CREDENTIALS=/path/to/sa.json
134
+ export GCP_PROJECT_ID=your-project
135
+ ```
136
+
137
+ ## Example Prompts
138
+
139
+ - *"Show me all CRITICAL findings across all clouds"*
140
+ - *"Which IAM roles have never been used in the last 90 days?"*
141
+ - *"Are any secrets overdue for rotation?"*
142
+ - *"Correlate all GuardDuty and Chronicle events for IP 1.2.3.4"*
143
+ - *"Run a CIS compliance check across AWS and GCP"*
144
+
145
+ ## Also Available via npm
146
+
147
+ ```bash
148
+ npx multicloud-security-mcp
149
+ # or
150
+ npm install -g multicloud-security-mcp
151
+ ```
152
+
153
+ ## License
154
+
155
+ MIT
@@ -0,0 +1,130 @@
1
+ # multicloud-security-mcp
2
+
3
+ [![PyPI version](https://img.shields.io/pypi/v/multicloud-security-mcp.svg)](https://pypi.org/project/multicloud-security-mcp/)
4
+ [![npm version](https://img.shields.io/npm/v/multicloud-security-mcp.svg)](https://www.npmjs.com/package/multicloud-security-mcp)
5
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
6
+
7
+ A production-ready **Model Context Protocol (MCP)** server providing unified security visibility across **AWS**, **Azure**, and **GCP**. Designed for AI agents and Claude Desktop.
8
+
9
+ **46 security tools** spanning threat detection, vulnerability management, IAM security, data protection, network security, key/secret management, container security, and compliance — all exposed through a single MCP server.
10
+
11
+ ## Install
12
+
13
+ ```bash
14
+ # pip
15
+ pip install multicloud-security-mcp
16
+
17
+ # uv
18
+ uv pip install multicloud-security-mcp
19
+
20
+ # pipx (isolated global install)
21
+ pipx install multicloud-security-mcp
22
+ ```
23
+
24
+ > **Prerequisite:** Node.js 20+ must be available on PATH. Install from [nodejs.org](https://nodejs.org) if needed.
25
+
26
+ ## Quick Start
27
+
28
+ ```bash
29
+ # Run the MCP server
30
+ multicloud-security-mcp
31
+
32
+ # Or via python module
33
+ python -m multicloud_security_mcp
34
+ ```
35
+
36
+ ## Claude Desktop Configuration
37
+
38
+ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
39
+
40
+ ### Using pip installation
41
+
42
+ ```json
43
+ {
44
+ "mcpServers": {
45
+ "multicloud-security": {
46
+ "command": "multicloud-security-mcp",
47
+ "env": {
48
+ "AWS_PROFILE": "security-audit",
49
+ "AZURE_CLIENT_ID": "your-app-id",
50
+ "AZURE_CLIENT_SECRET": "your-secret",
51
+ "AZURE_TENANT_ID": "your-tenant",
52
+ "AZURE_SUBSCRIPTION_ID": "your-sub",
53
+ "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/sa.json",
54
+ "GCP_PROJECT_ID": "your-project"
55
+ }
56
+ }
57
+ }
58
+ }
59
+ ```
60
+
61
+ ### Using uvx (no install needed)
62
+
63
+ ```json
64
+ {
65
+ "mcpServers": {
66
+ "multicloud-security": {
67
+ "command": "uvx",
68
+ "args": ["multicloud-security-mcp"],
69
+ "env": {
70
+ "AWS_PROFILE": "security-audit"
71
+ }
72
+ }
73
+ }
74
+ }
75
+ ```
76
+
77
+ ## What's Included
78
+
79
+ ### AWS (15 tools)
80
+ SecurityHub, GuardDuty, Inspector, IAM Analyzer, Macie, CloudTrail, Detective, Config Rules, WAF, Shield, Network Firewall, Secrets Manager, KMS, ECR, SSM Patch
81
+
82
+ ### Azure (13 tools)
83
+ Defender, Sentinel, Entra ID Protection, Purview DLP, Policy, Key Vault, Firewall, DDoS Protection, Container Registry, Network Watcher, Defender for Endpoint, App Service, DevOps Security
84
+
85
+ ### GCP (13 tools)
86
+ Security Command Center, Chronicle, IAM Recommender, Cloud DLP, Cloud Armor, Binary Authorization, Artifact Registry, VPC Service Controls, Cloud KMS, Secret Manager, Asset Inventory, Access Transparency, Audit Logs
87
+
88
+ ### Cross-Cloud (5 tools)
89
+ Critical Findings aggregation, Compliance Dashboard, IAM Blast Radius analysis, SIEM Correlation, Secret Rotation Audit
90
+
91
+ ## Cloud Authentication
92
+
93
+ Set environment variables for each cloud you want to use:
94
+
95
+ ```bash
96
+ # AWS
97
+ export AWS_ACCESS_KEY_ID=...
98
+ export AWS_SECRET_ACCESS_KEY=...
99
+ export AWS_DEFAULT_REGION=eu-west-1
100
+
101
+ # Azure
102
+ export AZURE_CLIENT_ID=...
103
+ export AZURE_CLIENT_SECRET=...
104
+ export AZURE_TENANT_ID=...
105
+ export AZURE_SUBSCRIPTION_ID=...
106
+
107
+ # GCP
108
+ export GOOGLE_APPLICATION_CREDENTIALS=/path/to/sa.json
109
+ export GCP_PROJECT_ID=your-project
110
+ ```
111
+
112
+ ## Example Prompts
113
+
114
+ - *"Show me all CRITICAL findings across all clouds"*
115
+ - *"Which IAM roles have never been used in the last 90 days?"*
116
+ - *"Are any secrets overdue for rotation?"*
117
+ - *"Correlate all GuardDuty and Chronicle events for IP 1.2.3.4"*
118
+ - *"Run a CIS compliance check across AWS and GCP"*
119
+
120
+ ## Also Available via npm
121
+
122
+ ```bash
123
+ npx multicloud-security-mcp
124
+ # or
125
+ npm install -g multicloud-security-mcp
126
+ ```
127
+
128
+ ## License
129
+
130
+ MIT
@@ -0,0 +1,5 @@
1
+ """Multi-Cloud Security MCP Server — unified security visibility across AWS, Azure, and GCP."""
2
+
3
+ __version__ = "1.0.0"
4
+
5
+ from .server import serve # noqa: F401
@@ -0,0 +1,5 @@
1
+ """Allow running as `python -m multicloud_security_mcp`."""
2
+
3
+ from .server import serve
4
+
5
+ serve()
@@ -0,0 +1,101 @@
1
+ """Thin Python wrapper that starts the Node.js MCP server."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import os
6
+ import shutil
7
+ import subprocess
8
+ import sys
9
+ from pathlib import Path
10
+
11
+
12
+ def _find_node() -> str:
13
+ """Locate a Node.js >= 20 binary on the system."""
14
+ node = shutil.which("node")
15
+ if node is None:
16
+ print(
17
+ "Error: Node.js is required but not found on PATH.\n"
18
+ "Install Node.js 20+ from https://nodejs.org or via your package manager.",
19
+ file=sys.stderr,
20
+ )
21
+ sys.exit(1)
22
+
23
+ try:
24
+ result = subprocess.run(
25
+ [node, "--version"],
26
+ capture_output=True,
27
+ text=True,
28
+ timeout=10,
29
+ )
30
+ version = result.stdout.strip().lstrip("v")
31
+ major = int(version.split(".")[0])
32
+ if major < 20:
33
+ print(
34
+ f"Error: Node.js >= 20 is required (found v{version}).\n"
35
+ "Upgrade at https://nodejs.org",
36
+ file=sys.stderr,
37
+ )
38
+ sys.exit(1)
39
+ except (subprocess.TimeoutExpired, ValueError, IndexError):
40
+ pass
41
+
42
+ return node
43
+
44
+
45
+ def _find_server_js() -> str:
46
+ """Locate the compiled index.js entry point."""
47
+ pkg_dir = Path(__file__).resolve().parent
48
+ bundled = pkg_dir / "dist" / "index.js"
49
+ if bundled.is_file():
50
+ return str(bundled)
51
+
52
+ repo_dist = pkg_dir.parent.parent / "dist" / "index.js"
53
+ if repo_dist.is_file():
54
+ return str(repo_dist)
55
+
56
+ return ""
57
+
58
+
59
+ def serve() -> None:
60
+ """Start the Multi-Cloud Security MCP server.
61
+
62
+ This function never returns — it replaces the current process with the
63
+ Node.js server (via exec on Unix, subprocess on Windows).
64
+ """
65
+ node = _find_node()
66
+ server_js = _find_server_js()
67
+
68
+ # Forward all env vars (cloud credentials, config, etc.)
69
+ env = os.environ.copy()
70
+
71
+ if server_js:
72
+ # Direct invocation — fastest path
73
+ args = [node, server_js]
74
+ else:
75
+ # Fallback: use npx to resolve the npm package
76
+ npx = shutil.which("npx")
77
+ if npx is None:
78
+ print(
79
+ "Error: Could not find the MCP server JS bundle or npx.\n"
80
+ "Either install the npm package:\n"
81
+ " npm install -g multicloud-security-mcp\n"
82
+ "Or rebuild from source:\n"
83
+ " npm run build",
84
+ file=sys.stderr,
85
+ )
86
+ sys.exit(1)
87
+ args = [npx, "multicloud-security-mcp"]
88
+
89
+ try:
90
+ # On Unix, exec replaces the process so signals propagate cleanly
91
+ if sys.platform != "win32":
92
+ os.execvpe(args[0], args, env)
93
+ else:
94
+ # On Windows, use subprocess and proxy the exit code
95
+ result = subprocess.run(args, env=env)
96
+ sys.exit(result.returncode)
97
+ except FileNotFoundError:
98
+ print(f"Error: Failed to execute {args[0]}", file=sys.stderr)
99
+ sys.exit(1)
100
+ except KeyboardInterrupt:
101
+ sys.exit(0)
@@ -0,0 +1,53 @@
1
+ [build-system]
2
+ requires = ["hatchling"]
3
+ build-backend = "hatchling.build"
4
+
5
+ [project]
6
+ name = "multicloud-security-mcp"
7
+ version = "1.0.0"
8
+ description = "Multi-Cloud Security MCP Server — unified security visibility across AWS, Azure, and GCP for AI agents and Claude Desktop"
9
+ readme = "README.md"
10
+ license = "MIT"
11
+ requires-python = ">=3.10"
12
+ authors = [
13
+ { name = "Mahendran Selvakumar" },
14
+ ]
15
+ keywords = [
16
+ "mcp",
17
+ "model-context-protocol",
18
+ "security",
19
+ "cloud-security",
20
+ "aws",
21
+ "azure",
22
+ "gcp",
23
+ "multicloud",
24
+ "claude",
25
+ "ai-agent",
26
+ "siem",
27
+ "devsecops",
28
+ ]
29
+ classifiers = [
30
+ "Development Status :: 4 - Beta",
31
+ "Intended Audience :: Developers",
32
+ "Intended Audience :: System Administrators",
33
+ "License :: OSI Approved :: MIT License",
34
+ "Operating System :: OS Independent",
35
+ "Programming Language :: Python :: 3",
36
+ "Programming Language :: Python :: 3.10",
37
+ "Programming Language :: Python :: 3.11",
38
+ "Programming Language :: Python :: 3.12",
39
+ "Programming Language :: Python :: 3.13",
40
+ "Topic :: Security",
41
+ "Topic :: System :: Systems Administration",
42
+ ]
43
+
44
+ [project.urls]
45
+ Homepage = "https://github.com/skmahe1077/multicloud-security-mcp"
46
+ Repository = "https://github.com/skmahe1077/multicloud-security-mcp"
47
+ Issues = "https://github.com/skmahe1077/multicloud-security-mcp/issues"
48
+
49
+ [project.scripts]
50
+ multicloud-security-mcp = "multicloud_security_mcp:serve"
51
+
52
+ [tool.hatch.build.targets.wheel]
53
+ packages = ["multicloud_security_mcp"]