iflow-mcp_anton-prosterity-documentation-search-enhanced 1.9.0__py3-none-any.whl

iflow_mcp_anton_prosterity_documentation_search_enhanced-1.9.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,26 @@
+documentation_search_enhanced/__init__.py,sha256=cflYnRVxahapQaCJD6m3U-bVn-POevFzHM7NJ7Xyxuo,339
+documentation_search_enhanced/__main__.py,sha256=Pz0FXFQw0m25k0ShyLyxnb3BZ_lmKMslDegIcrc5wts,136
+documentation_search_enhanced/config.json,sha256=VjRptzJ9uAn7C78QP8xK6aGuuLzhhqXiV0vRdnS6sh8,66899
+documentation_search_enhanced/config_manager.py,sha256=VBqju4Iq3RZyPN_0sOkjKvnNUVYBOa-uZWHcL7AmRKY,8398
+documentation_search_enhanced/config_validator.py,sha256=sx1lWnV6BFWFSil2i5Co4gTC0srltvbQp2siI_n55Z0,2152
+documentation_search_enhanced/content_enhancer.py,sha256=4q0uj9_qBtcNovBwX1jgpNuq7RXauPGbYmXGidx2ifU,21147
+documentation_search_enhanced/docker_manager.py,sha256=GjHBwF75OOkS9ikChkLUCBTf9D948dEUDsMWdwJUNAg,2643
+documentation_search_enhanced/logger.py,sha256=RL8dvcSQZkVqQIKwNK3BT9_nmCBzZlEXx03_vXe3xlc,5389
+documentation_search_enhanced/main.py,sha256=9yCWbfxnAwdJ7EEtMYWjx03UJEbJdEwgzWdXkzJJNjw,74533
+documentation_search_enhanced/project_generator.py,sha256=FtoQeqgvxqMQvgy9R5wZ649e6evhr9gE0pTo_85l9rM,5881
+documentation_search_enhanced/project_scanner.py,sha256=1ZoLMINXn1uY7JGdSUnj7FLqJOyOjIIS4AGxgZWfwpg,2701
+documentation_search_enhanced/reranker.py,sha256=elT-96cfvJUx7C-UvV9sAeRIeIAbkKb7MAx8LrGlyOA,7393
+documentation_search_enhanced/site_index_builder.py,sha256=Xu0dHr8tJfSE9cW8c0zdHUPW2_ne3hfqANkNZUuq2Aw,8880
+documentation_search_enhanced/site_index_downloader.py,sha256=txED6ejgyJrspm4Den6fqpwyzTaHpVlnvx4Uu34jTVg,6776
+documentation_search_enhanced/site_search.py,sha256=0E0vygKEC_02gI689QW9grkybN0T-C3t47fkypZdEVc,41789
+documentation_search_enhanced/smart_search.py,sha256=n-UtZVgusx7u44AvnadIPMp5TqYzcXT-3V-cy8uOd9Y,16824
+documentation_search_enhanced/snyk_integration.py,sha256=P3qbzxHQLvjCdyayBzH8EKyTVqWLWRgLX9AzybUA9Qo,23833
+documentation_search_enhanced/vector_search.py,sha256=T_ImmRRNqqQVcHvX-peL8zn6Bc_Q7rSUliQxEHmUObM,9276
+documentation_search_enhanced/version_resolver.py,sha256=fYmjrGhk_-NVCwKTpRnmtL658cWVlCRpVIqjHw2fihY,6578
+documentation_search_enhanced/vulnerability_scanner.py,sha256=YOg4lg_47XeBuvEgh1oB2ba0cAsB1rTBQXMFuWW5ixU,20388
+documentation_search_enhanced/web_scraper.py,sha256=ntLLCf1V4W9AL6nppEBciLm_wUMfNPKD0a4D7n9OcJE,4211
+iflow_mcp_anton_prosterity_documentation_search_enhanced-1.9.0.dist-info/METADATA,sha256=qbSkzyKMUvLJ4x9vO0nMxlSc2Jg53E1U97QM-v3PnLs,6947
+iflow_mcp_anton_prosterity_documentation_search_enhanced-1.9.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+iflow_mcp_anton_prosterity_documentation_search_enhanced-1.9.0.dist-info/entry_points.txt,sha256=sy1CibFyGdYhC4-FRDoCytTqlR-gdgSRHmamMFpsmUI,117
+iflow_mcp_anton_prosterity_documentation_search_enhanced-1.9.0.dist-info/licenses/LICENSE,sha256=Wh7rAOlQ9yAfxGTlIm-6egm_kv5Tv6AQ7ca_oIZZf4o,1069
+iflow_mcp_anton_prosterity_documentation_search_enhanced-1.9.0.dist-info/RECORD,,

iflow_mcp_anton_prosterity_documentation_search_enhanced-1.9.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

iflow_mcp_anton_prosterity_documentation_search_enhanced-1.9.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+iflow-mcp_anton-prosterity-documentation-search-enhanced = documentation_search_enhanced.main:main

iflow_mcp_anton_prosterity_documentation_search_enhanced-1.9.0.dist-info/licenses/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.