generate-tech-stack-mcp 0.2.0__py3-none-any.whl

generate_tech_stack_mcp/server.py

@@ -0,0 +1,163 @@
+#!/usr/bin/env python3
+"""
+generate-tech-stack MCP Server
+Universal — works with Claude Desktop, VS Code (Copilot via MCP), Cursor,
+Zed, Windsurf, Continue, Antigravity, and any MCP-compatible host.
+
+Install:  pip install generate-tech-stack-mcp
+Run:      generate-tech-stack-mcp
+
+Add to your MCP host config (e.g. claude_desktop_config.json):
+    {
+      "mcpServers": {
+        "generate-tech-stack": { "command": "generate-tech-stack-mcp" }
+      }
+    }
+
+Then ask: /generate-tech-stack  or  "generate my tech stack"
+"""
+
+import asyncio
+import json
+import os
+import sys
+from pathlib import Path
+
+try:
+    from mcp.server import Server
+    from mcp.server.stdio import stdio_server
+    import mcp.types as types
+except ImportError:
+    print("ERROR: mcp package not found. Run: pip install mcp", file=sys.stderr)
+    sys.exit(1)
+
+from generate_tech_stack_mcp import analyze as _analyze
+
+server = Server("generate-tech-stack")
+
+
+@server.list_tools()
+async def handle_list_tools() -> list[types.Tool]:
+    return [
+        types.Tool(
+            name="generate_tech_stack",
+            description=(
+                "Scan a project directory and generate a TECH_STACK.html visual page. "
+                "Includes a stat row, layered architecture diagram, bar chart summary, "
+                "and colour-coded tool cards. Detects languages, frameworks, databases, "
+                "AI SDKs, testing, observability, security, and infrastructure tools."
+            ),
+            inputSchema={
+                "type": "object",
+                "properties": {
+                    "project_dir": {
+                        "type": "string",
+                        "description": "Absolute path to the project root. Defaults to cwd.",
+                    },
+                    "output_file": {
+                        "type": "string",
+                        "description": "Path for the output HTML. Defaults to <project_dir>/TECH_STACK.html.",
+                    },
+                    "open_browser": {
+                        "type": "boolean",
+                        "description": "Open the file in the default browser after creation.",
+                        "default": True,
+                    },
+                },
+                "required": [],
+            },
+        ),
+        types.Tool(
+            name="list_tech_stack",
+            description=(
+                "Scan a project and return the tech stack as structured JSON "
+                "(no HTML file written). Good for programmatic use."
+            ),
+            inputSchema={
+                "type": "object",
+                "properties": {
+                    "project_dir": {
+                        "type": "string",
+                        "description": "Absolute path to the project root.",
+                    },
+                },
+                "required": [],
+            },
+        ),
+    ]
+
+
+@server.call_tool()
+async def handle_call_tool(name: str, arguments: dict) -> list[types.TextContent]:
+    project_dir = Path(arguments.get("project_dir") or os.getcwd()).resolve()
+
+    if not project_dir.exists():
+        return [types.TextContent(type="text", text=f"ERROR: Directory not found: {project_dir}")]
+
+    if name == "list_tech_stack":
+        tools = _analyze.collect(project_dir)
+        total = sum(len(v) for v in tools.values())
+        result = {
+            "project":     project_dir.name,
+            "total_tools": total,
+            "categories": {
+                cat: [{"name": t["name"], "desc": t["desc"]} for t in items]
+                for cat, items in tools.items()
+            },
+        }
+        return [types.TextContent(type="text", text=json.dumps(result, indent=2))]
+
+    if name == "generate_tech_stack":
+        output_file = Path(
+            arguments.get("output_file") or (project_dir / "TECH_STACK.html")
+        ).resolve()
+
+        tools = _analyze.collect(project_dir)
+        if not tools:
+            return [types.TextContent(type="text",
+                text=f"No recognizable dependency files found in: {project_dir}")]
+
+        project_name = project_dir.name.replace("-", " ").replace("_", " ").title()
+        output_file.write_text(_analyze.render_html(tools, project_name))
+
+        total = sum(len(v) for v in tools.values())
+        lines = [
+            f"Tech stack generated: {output_file}",
+            f"Detected {total} tools across {len(tools)} categories:",
+        ]
+        for cat, items in tools.items():
+            meta  = _analyze.CATEGORY_META.get(cat, _analyze.CATEGORY_META["other"])
+            names = ", ".join(t["name"] for t in items)
+            lines.append(f"  {meta['icon']} {meta['label']}: {names}")
+
+        if arguments.get("open_browser", True):
+            import subprocess
+            for cmd in ["xdg-open", "open", "start"]:
+                try:
+                    subprocess.Popen([cmd, str(output_file)],
+                                     stdout=subprocess.DEVNULL,
+                                     stderr=subprocess.DEVNULL)
+                    break
+                except FileNotFoundError:
+                    continue
+
+        return [types.TextContent(type="text", text="\n".join(lines))]
+
+    return [types.TextContent(type="text", text=f"Unknown tool: {name}")]
+
+
+async def _run():
+    async with stdio_server() as (read_stream, write_stream):
+        await server.run(
+            read_stream,
+            write_stream,
+            server.create_initialization_options(),
+        )
+
+
+def main():
+    asyncio.run(_run())
+
+
+if __name__ == "__main__":
+    main()

generate_tech_stack_mcp-0.2.0.dist-info/METADATA

@@ -0,0 +1,207 @@
+Metadata-Version: 2.4
+Name: generate-tech-stack-mcp
+Version: 0.2.0
+Summary: Generate a visual technology-stack inventory (TECH_STACK.html) from any codebase — languages, frameworks, databases, AI SDKs, testing, and infra. CLI + MCP server, stdlib-only scanner.
+Author: Ashutosh Kumar
+License: MIT
+Project-URL: Homepage, https://github.com/askuma/generate-tech-stack
+Project-URL: Repository, https://github.com/askuma/generate-tech-stack
+Project-URL: Live Demo, https://askuma.github.io/generate-tech-stack/
+Keywords: mcp,mcp-server,tech-stack,dependencies,inventory,static-analysis,claude
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Documentation
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp>=1.0.0
+Dynamic: license-file
+
+# generate-tech-stack
+
+<!-- mcp-name: io.github.askuma/generate-tech-stack -->
+
+Scan any project and generate a visual `TECH_STACK.html` page — dark-mode, auto-adapting, zero config.
+
+Works as a **Claude Code skill**, **MCP server**, or **GitHub Copilot Extension**.
+
+**[Live demo →](https://askuma.github.io/generate-tech-stack/)** — generated from
+[fastapi/full-stack-fastapi-template](https://github.com/fastapi/full-stack-fastapi-template), unmodified.
+
+![TECH_STACK.html generated for full-stack-fastapi-template](https://raw.githubusercontent.com/askuma/generate-tech-stack/main/docs/preview.png)
+
+---
+
+## What it produces
+
+Every generated page contains:
+
+| Section | Description |
+|---|---|
+| **Stat row** | Total tools · Categories · AI Backends · Data Stores |
+| **Architecture diagram** | Layered flow diagram (Consumer → API → AI/NLP → Data/Obs/Frontend) |
+| **Bar chart** | Horizontal bars per category, colour-matched |
+| **Tool cards** | One card per category; each tool shows a dot, name, description, and badge |
+| **Badge legend** | Explains `pip`, `dep`, `optional`, `core`, `deploy`, `ci`, etc. |
+| **Footer** | Project name · tool count · generation date |
+
+---
+
+## Repository layout
+
+```
+~/.claude/skills/generate-tech-stack/
+├── SKILL.md                  ← Claude Code skill definition
+├── INSTALL.md                ← detailed per-platform installation guide
+├── README.md                 ← this file
+├── scripts/
+│   └── analyze.py            ← core scanner + HTML renderer (no dependencies)
+├── mcp/
+│   ├── server.py             ← MCP stdio server (pip install mcp)
+│   └── requirements.txt
+└── copilot/
+    ├── index.js              ← GitHub Copilot Extension (Express)
+    ├── package.json
+    └── openai_function.json  ← OpenAI / Antigravity function definition
+```
+
+---
+
+## Usage
+
+### pip (CLI + MCP server)
+
+```bash
+pip install generate-tech-stack-mcp
+
+generate-tech-stack . TECH_STACK.html    # CLI: scan and write the report
+generate-tech-stack-mcp                   # stdio MCP server
+```
+
+With pip installed, any MCP host config reduces to:
+
+```json
+{
+  "mcpServers": {
+    "generate-tech-stack": { "command": "generate-tech-stack-mcp" }
+  }
+}
+```
+
+### Claude Code
+
+```
+/generate-tech-stack
+```
+
+Run it from any project directory. The skill calls `scripts/analyze.py` and opens the result in your browser.
+
+### MCP (Claude Desktop, VS Code, Cursor, Zed, Windsurf, Continue)
+
+```bash
+pip install mcp
+```
+
+Add to your host's MCP config (replace the path with your actual home directory):
+
+```json
+{
+  "mcpServers": {
+    "generate-tech-stack": {
+      "command": "python3",
+      "args": ["/home/<you>/.claude/skills/generate-tech-stack/mcp/server.py"]
+    }
+  }
+}
+```
+
+Then ask: `generate my tech stack` or `/generate-tech-stack`.
+
+**MCP tools exposed:**
+- `generate_tech_stack` — scans a project, writes `TECH_STACK.html`, opens in browser
+- `list_tech_stack` — returns a JSON summary, no file written
+
+### GitHub Copilot Extension
+
+```bash
+cd copilot
+npm install
+npm start        # listens on port 3000
+ngrok http 3000  # expose for GitHub to reach
+```
+
+Register a GitHub App with **Copilot Extension** enabled, set the Agent URL to `https://your-url/agent`, and install it on your account. Then in Copilot Chat:
+
+```
+@generate-tech-stack /generate-tech-stack
+@generate-tech-stack /generate-tech-stack /path/to/project
+```
+
+### Command line (standalone)
+
+```bash
+python3 ~/.claude/skills/generate-tech-stack/scripts/analyze.py /path/to/project
+# output: /path/to/project/TECH_STACK.html
+
+# custom output path:
+python3 scripts/analyze.py . ~/Desktop/TECH_STACK.html
+```
+
+`analyze.py` has no third-party dependencies — just Python 3.8+.
+
+---
+
+## What gets detected
+
+| Source file | Detected tools |
+|---|---|
+| `requirements.txt` / `pyproject.toml` | Python packages (web, DB, AI, testing, observability, security…) |
+| `package.json` | Node / npm packages (frameworks, frontend, DB drivers, tooling) |
+| `go.mod` | Go language |
+| `Cargo.toml` | Rust language |
+| `pom.xml` / `build.gradle` | Java / Kotlin |
+| `Gemfile` | Ruby |
+| `composer.json` | PHP |
+| `**/*.py` source | Optional/dynamic SDKs via `importlib.find_spec()` patterns |
+| `docker-compose.yml` / `.env` | PostgreSQL, Redis, MongoDB, SQLite connection strings |
+| `Dockerfile` | Docker |
+| `docker-compose.yml` | Docker Compose |
+| `.github/workflows/` | GitHub Actions |
+| `.gitlab-ci.yml` | GitLab CI |
+| `alembic.ini` | Alembic migrations |
+| `nginx.conf` / `Caddyfile` | Reverse proxy |
+| `tsconfig.json` / `src/**/*.ts` | TypeScript |
+
+---
+
+## Detected categories
+
+| Category | Colour | Examples |
+|---|---|---|
+| Language & Runtime | Green | Python, Go, Rust, TypeScript |
+| Web / API Framework | Purple | FastAPI, Express, Django, Next.js |
+| Database / Storage | Green | SQLAlchemy, Prisma, Redis, ChromaDB |
+| AI Guardrail SDKs | Blue | GuardrailsAI, NVIDIA NeMo, Presidio, Lakera |
+| NLP / ML | Teal | spaCy, Transformers, Sentence Transformers |
+| Observability | Teal | Prometheus, OpenTelemetry, Sentry, Loguru |
+| Testing | Yellow | pytest, Jest, Cypress, Playwright |
+| Security / Auth | Rose | PyJWT, bcrypt, Authlib, Helmet |
+| Infrastructure / Deploy | Orange | Docker, Kubernetes, Celery, Boto3 |
+| Frontend / Dashboard | Gray | React, Vue, Tailwind, Recharts |
+| Messaging / Comms | Blue | Kafka, RabbitMQ, Socket.io |
+| Dev Tools | Gray | ESLint, Prettier, Vite, TypeScript |
+
+---
+
+## Design
+
+Dark-mode only. Fonts: **IBM Plex Sans** (body) + **JetBrains Mono** (code/badges), loaded from Google Fonts. No JavaScript — pure HTML + CSS. Self-contained single file, opens in any browser offline.
+
+---
+
+## See also
+
+- [INSTALL.md](INSTALL.md) — per-platform setup instructions
+- [SKILL.md](SKILL.md) — Claude Code skill specification

generate_tech_stack_mcp-0.2.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+generate_tech_stack_mcp/__init__.py,sha256=pzTcB3QF1p03CzooQO79pnfS2UBzps_YfudDFxJEix0,106
+generate_tech_stack_mcp/analyze.py,sha256=3moRyfsLWuAOd5lNo77QHwX3whmq2UYK3axZaaLTEt4,50294
+generate_tech_stack_mcp/server.py,sha256=bBBvzgASW5SKj9BQgEimliAJ8lJ6EhWp5nlT9QmfB_c,5568
+generate_tech_stack_mcp-0.2.0.dist-info/licenses/LICENSE,sha256=k1Mx2UUhlahBiae3uzw2oGHhMN98awy7RztDPeJwIvI,1071
+generate_tech_stack_mcp-0.2.0.dist-info/METADATA,sha256=AZcTmD5yS-F5cTx3eSjNJmL3z1F4mEniO5osYWvryg0,6846
+generate_tech_stack_mcp-0.2.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+generate_tech_stack_mcp-0.2.0.dist-info/entry_points.txt,sha256=bAZhRj-mjrrYtu4pUy7CzYwgeMlkLxCe3PaBy6Hda8g,139
+generate_tech_stack_mcp-0.2.0.dist-info/top_level.txt,sha256=s8p9Nz7Dtk9vE_UTs6vTAl3vsPBU4COqRW_XytwuHYA,24
+generate_tech_stack_mcp-0.2.0.dist-info/RECORD,,

generate_tech_stack_mcp-0.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

generate_tech_stack_mcp-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+generate-tech-stack = generate_tech_stack_mcp.analyze:main
+generate-tech-stack-mcp = generate_tech_stack_mcp.server:main

generate_tech_stack_mcp-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ashutosh Kumar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

generate_tech_stack_mcp-0.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+generate_tech_stack_mcp