iflow-mcp_anton-prosterity-documentation-search-enhanced 1.9.0__tar.gz

iflow_mcp_anton_prosterity_documentation_search_enhanced-1.9.0/.gitignore

@@ -0,0 +1,27 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+.env
+
+# Local documentation files (not tracked in git)
+COMPETITIVE_ANALYSIS.md
+COMPETITIVE_STRATEGY.pdf
+CURSOR_COMMUNITY_POST.md
+DEMO_VIDEO_SCRIPT.md
+DYNAMIC_CONFIG_ANALYSIS.md
+HYBRID_SETUP_GUIDE.md
+TECHNICAL_DEEP_DIVE.md
+TEST_CURSOR_INTEGRATION.md
+COMPETITIVE_STRATEGY.md
+
+# Generated docs site index assets
+docs_site_index.json
+docs_site_index.json.gz
+docs_site_index.json.docs_site_index.json.gz

iflow_mcp_anton_prosterity_documentation_search_enhanced-1.9.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Anton Mishel
+
+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. 

iflow_mcp_anton_prosterity_documentation_search_enhanced-1.9.0/PKG-INFO

@@ -0,0 +1,195 @@
+Metadata-Version: 2.4
+Name: iflow-mcp_anton-prosterity-documentation-search-enhanced
+Version: 1.9.0
+Summary: Enhanced MCP server for searching documentation with OSINT vulnerability scanning, security analysis, and AWS-style deployment
+Project-URL: Homepage, https://github.com/anton-prosterity/documentation-search-mcp
+Project-URL: Repository, https://github.com/anton-prosterity/documentation-search-mcp
+Project-URL: Issues, https://github.com/anton-prosterity/documentation-search-mcp/issues
+Author-email: Anton Mishel <your-email@example.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,assistant,documentation,fastapi,langchain,mcp,osint,osv,search,security,vulnerability
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
+Classifier: Topic :: Software Development :: Documentation
+Requires-Python: >=3.12
+Requires-Dist: beautifulsoup4>=4.13.4
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: mcp[cli]>=1.23.0
+Requires-Dist: playwright>=1.40.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: pyyaml>=6.0.1
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Requires-Dist: twine>=4.0.0; extra == 'dev'
+Provides-Extra: vector
+Requires-Dist: faiss-cpu>=1.7.4; extra == 'vector'
+Requires-Dist: numpy>=1.24.0; extra == 'vector'
+Requires-Dist: sentence-transformers>=2.2.0; extra == 'vector'
+Description-Content-Type: text/markdown
+
+# Documentation Search MCP Server
+
+[![CI](https://github.com/antonmishel/documentation-search-mcp/workflows/CI%20-%20Test%20&%20Quality/badge.svg)](https://github.com/antonmishel/documentation-search-mcp/actions/workflows/ci.yml)
+[![Security Scan](https://github.com/antonmishel/documentation-search-mcp/workflows/Security%20Scan/badge.svg)](https://github.com/antonmishel/documentation-search-mcp/actions/workflows/security.yml)
+[![PyPI version](https://badge.fury.io/py/documentation-search-enhanced.svg)](https://pypi.org/project/documentation-search-enhanced/)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+MCP server for searching documentation, scanning dependencies for vulnerabilities, and generating project boilerplate. Works with Claude Desktop, Cursor, and other MCP clients.
+
+**📚 [Read the comprehensive tutorial](TUTORIAL.md)** for detailed examples and workflows.
+
+## Features
+
+- Search 190+ curated documentation sources with optional semantic vector search
+- Scan Python projects for vulnerabilities (Snyk, Safety, OSV)
+- Generate FastAPI and React project starters
+- Learning paths and code examples
+
+## Installation
+
+```bash
+# Recommended: use uvx (install uv from https://docs.astral.sh/uv)
+uvx documentation-search-enhanced@1.9.0
+
+# Or with pip in a virtual environment
+pip install documentation-search-enhanced==1.9.0
+
+# Optional: AI semantic search (Python 3.12 only, adds ~600MB)
+pip install documentation-search-enhanced[vector]==1.9.0
+```
+
+## Configuration
+
+### Claude Desktop
+
+Find your uvx path: `which uvx`
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "documentation-search-enhanced": {
+      "command": "/Users/yourusername/.local/bin/uvx",
+      "args": ["documentation-search-enhanced@1.9.0"],
+      "env": {
+        "SERPER_API_KEY": "optional_key_here"
+      }
+    }
+  }
+}
+```
+
+Replace `/Users/yourusername/.local/bin/uvx` with your actual uvx path.
+
+### Codex CLI
+
+```bash
+# Find your uvx path first
+which uvx
+
+# Then add with full path (replace with your actual path)
+codex mcp add documentation-search-enhanced \
+  -- /Users/yourusername/.local/bin/uvx documentation-search-enhanced@1.9.0
+
+# Or if uvx is in PATH:
+codex mcp add documentation-search-enhanced \
+  -- uvx documentation-search-enhanced@1.9.0
+```
+
+**With SERPER API Key** (enables live web search):
+```bash
+codex mcp add documentation-search-enhanced \
+  --env SERPER_API_KEY=your_key_here \
+  -- /Users/yourusername/.local/bin/uvx documentation-search-enhanced@1.9.0
+```
+
+**Without SERPER API Key** (uses prebuilt index from GitHub Releases):
+```bash
+codex mcp add documentation-search-enhanced \
+  -- /Users/yourusername/.local/bin/uvx documentation-search-enhanced@1.9.0
+```
+
+If you get a timeout on first run, pre-download dependencies:
+```bash
+uvx documentation-search-enhanced@1.9.0
+```
+
+### Environment Variables
+
+- `SERPER_API_KEY` - Optional. Enables live web search. Without it, uses prebuilt index from GitHub Releases.
+- `DOCS_SITE_INDEX_AUTO_DOWNLOAD` - Set to `false` to disable automatic index downloads
+- `DOCS_SITE_INDEX_PATH` - Custom path for documentation index
+
+Set `server_config.features.real_time_search=false` in your config to disable live crawling.
+
+## Semantic Search (Optional)
+
+The `[vector]` extra adds semantic search using sentence-transformers (all-MiniLM-L6-v2) with hybrid reranking:
+
+- 50% semantic similarity (cosine)
+- 30% keyword matching
+- 20% source authority
+
+Only works on Python 3.12 (PyTorch limitation). Python 3.13 users get keyword-based search.
+
+To disable vector search even when installed:
+```python
+semantic_search(query="FastAPI auth", libraries=["fastapi"], use_vector_rerank=False)
+```
+
+## Available Tools
+
+Core MCP tools:
+- `semantic_search` - Search documentation
+- `get_docs` - Fetch specific documentation
+- `get_learning_path` - Generate learning roadmap
+- `get_code_examples` - Find code snippets
+- `scan_project_dependencies` - Vulnerability scan
+- `snyk_scan_project` - Detailed Snyk analysis
+- `generate_project_starter` - Create project boilerplate
+- `manage_dev_environment` - Generate docker-compose files
+- `compare_library_security` - Compare library vulnerabilities
+
+## Development
+
+```bash
+git clone https://github.com/anton-prosterity/documentation-search-mcp.git
+cd documentation-search-mcp
+uv sync --all-extras
+uv run python -m documentation_search_enhanced.main
+```
+
+### Testing
+
+```bash
+uv run pytest --ignore=pytest-test-project  # Core tests
+uv run ruff check src                       # Linting
+uv run ruff format src --check              # Format check
+```
+
+### Configuration
+
+Use the `get_current_config` tool to export current settings to `config.json`. Validate with:
+```bash
+uv run python src/documentation_search_enhanced/config_validator.py
+```
+
+## Contributing
+
+See `CONTRIBUTING.md` for guidelines. Use Conventional Commits for commit messages.
+
+## License
+
+MIT License - see `LICENSE` for details.

iflow_mcp_anton_prosterity_documentation_search_enhanced-1.9.0/README.md

@@ -0,0 +1,156 @@
+# Documentation Search MCP Server
+
+[![CI](https://github.com/antonmishel/documentation-search-mcp/workflows/CI%20-%20Test%20&%20Quality/badge.svg)](https://github.com/antonmishel/documentation-search-mcp/actions/workflows/ci.yml)
+[![Security Scan](https://github.com/antonmishel/documentation-search-mcp/workflows/Security%20Scan/badge.svg)](https://github.com/antonmishel/documentation-search-mcp/actions/workflows/security.yml)
+[![PyPI version](https://badge.fury.io/py/documentation-search-enhanced.svg)](https://pypi.org/project/documentation-search-enhanced/)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+MCP server for searching documentation, scanning dependencies for vulnerabilities, and generating project boilerplate. Works with Claude Desktop, Cursor, and other MCP clients.
+
+**📚 [Read the comprehensive tutorial](TUTORIAL.md)** for detailed examples and workflows.
+
+## Features
+
+- Search 190+ curated documentation sources with optional semantic vector search
+- Scan Python projects for vulnerabilities (Snyk, Safety, OSV)
+- Generate FastAPI and React project starters
+- Learning paths and code examples
+
+## Installation
+
+```bash
+# Recommended: use uvx (install uv from https://docs.astral.sh/uv)
+uvx documentation-search-enhanced@1.9.0
+
+# Or with pip in a virtual environment
+pip install documentation-search-enhanced==1.9.0
+
+# Optional: AI semantic search (Python 3.12 only, adds ~600MB)
+pip install documentation-search-enhanced[vector]==1.9.0
+```
+
+## Configuration
+
+### Claude Desktop
+
+Find your uvx path: `which uvx`
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "documentation-search-enhanced": {
+      "command": "/Users/yourusername/.local/bin/uvx",
+      "args": ["documentation-search-enhanced@1.9.0"],
+      "env": {
+        "SERPER_API_KEY": "optional_key_here"
+      }
+    }
+  }
+}
+```
+
+Replace `/Users/yourusername/.local/bin/uvx` with your actual uvx path.
+
+### Codex CLI
+
+```bash
+# Find your uvx path first
+which uvx
+
+# Then add with full path (replace with your actual path)
+codex mcp add documentation-search-enhanced \
+  -- /Users/yourusername/.local/bin/uvx documentation-search-enhanced@1.9.0
+
+# Or if uvx is in PATH:
+codex mcp add documentation-search-enhanced \
+  -- uvx documentation-search-enhanced@1.9.0
+```
+
+**With SERPER API Key** (enables live web search):
+```bash
+codex mcp add documentation-search-enhanced \
+  --env SERPER_API_KEY=your_key_here \
+  -- /Users/yourusername/.local/bin/uvx documentation-search-enhanced@1.9.0
+```
+
+**Without SERPER API Key** (uses prebuilt index from GitHub Releases):
+```bash
+codex mcp add documentation-search-enhanced \
+  -- /Users/yourusername/.local/bin/uvx documentation-search-enhanced@1.9.0
+```
+
+If you get a timeout on first run, pre-download dependencies:
+```bash
+uvx documentation-search-enhanced@1.9.0
+```
+
+### Environment Variables
+
+- `SERPER_API_KEY` - Optional. Enables live web search. Without it, uses prebuilt index from GitHub Releases.
+- `DOCS_SITE_INDEX_AUTO_DOWNLOAD` - Set to `false` to disable automatic index downloads
+- `DOCS_SITE_INDEX_PATH` - Custom path for documentation index
+
+Set `server_config.features.real_time_search=false` in your config to disable live crawling.
+
+## Semantic Search (Optional)
+
+The `[vector]` extra adds semantic search using sentence-transformers (all-MiniLM-L6-v2) with hybrid reranking:
+
+- 50% semantic similarity (cosine)
+- 30% keyword matching
+- 20% source authority
+
+Only works on Python 3.12 (PyTorch limitation). Python 3.13 users get keyword-based search.
+
+To disable vector search even when installed:
+```python
+semantic_search(query="FastAPI auth", libraries=["fastapi"], use_vector_rerank=False)
+```
+
+## Available Tools
+
+Core MCP tools:
+- `semantic_search` - Search documentation
+- `get_docs` - Fetch specific documentation
+- `get_learning_path` - Generate learning roadmap
+- `get_code_examples` - Find code snippets
+- `scan_project_dependencies` - Vulnerability scan
+- `snyk_scan_project` - Detailed Snyk analysis
+- `generate_project_starter` - Create project boilerplate
+- `manage_dev_environment` - Generate docker-compose files
+- `compare_library_security` - Compare library vulnerabilities
+
+## Development
+
+```bash
+git clone https://github.com/anton-prosterity/documentation-search-mcp.git
+cd documentation-search-mcp
+uv sync --all-extras
+uv run python -m documentation_search_enhanced.main
+```
+
+### Testing
+
+```bash
+uv run pytest --ignore=pytest-test-project  # Core tests
+uv run ruff check src                       # Linting
+uv run ruff format src --check              # Format check
+```
+
+### Configuration
+
+Use the `get_current_config` tool to export current settings to `config.json`. Validate with:
+```bash
+uv run python src/documentation_search_enhanced/config_validator.py
+```
+
+## Contributing
+
+See `CONTRIBUTING.md` for guidelines. Use Conventional Commits for commit messages.
+
+## License
+
+MIT License - see `LICENSE` for details.

iflow_mcp_anton_prosterity_documentation_search_enhanced-1.9.0/pyproject.toml

@@ -0,0 +1,87 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "iflow-mcp_anton-prosterity-documentation-search-enhanced"
+version = "1.9.0"
+description = "Enhanced MCP server for searching documentation with OSINT vulnerability scanning, security analysis, and AWS-style deployment"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.12"
+authors = [
+    { name = "Anton Mishel", email = "your-email@example.com" },
+]
+keywords = ["mcp", "documentation", "search", "fastapi", "langchain", "ai", "assistant", "security", "vulnerability", "osint", "osv"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Documentation",
+    "Topic :: Internet :: WWW/HTTP :: Indexing/Search",
+]
+
+dependencies = [
+    "beautifulsoup4>=4.13.4",
+    "httpx>=0.28.1",
+    "mcp[cli]>=1.23.0",
+    "python-dotenv>=1.0.0",
+    "PyYAML>=6.0.1",
+    "playwright>=1.40.0",
+    "pydantic>=2.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/anton-prosterity/documentation-search-mcp"
+Repository = "https://github.com/anton-prosterity/documentation-search-mcp"
+Issues = "https://github.com/anton-prosterity/documentation-search-mcp/issues"
+
+[project.scripts]
+iflow-mcp_anton-prosterity-documentation-search-enhanced = "documentation_search_enhanced.main:main"
+
+[project.optional-dependencies]
+vector = [
+    "sentence-transformers>=2.2.0",
+    "faiss-cpu>=1.7.4",
+    "numpy>=1.24.0",
+]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "black>=23.0.0",
+    "ruff>=0.1.0",
+    "twine>=4.0.0",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/documentation_search_enhanced"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "src/documentation_search_enhanced",
+    "config.json",
+    "README.md",
+    "LICENSE",
+]
+
+[dependency-groups]
+dev = [
+    "twine>=6.1.0",
+]
+
+[tool.pytest.ini_options]
+minversion = "7.0"
+addopts = "-ra"
+norecursedirs = [
+    ".git",
+    ".venv",
+    ".uv-cache",
+    "build",
+    "dist",
+    "pytest-test-project",
+    "samples",
+    "my-test-fastapi-app",
+]

iflow_mcp_anton_prosterity_documentation_search_enhanced-1.9.0/pytest-test-project/README.md

@@ -0,0 +1,10 @@
+# pytest-test-project
+
+A new FastAPI project generated by Documentation Search Enhanced MCP.
+
+## To run:
+1. `uv pip sync`
+2. `uv run uvicorn main:app --reload`
+
+## To test:
+`uv run pytest`