Metadata-Version: 2.4
Name: pwndoc-mcp-server
Version: 1.0.0.post1
Summary: Model Context Protocol server for PwnDoc penetration testing documentation
Project-URL: Homepage, https://github.com/walidfaour/pwndoc-mcp-server
Project-URL: Documentation, https://github.com/walidfaour/pwndoc-mcp-server#readme
Project-URL: Repository, https://github.com/walidfaour/pwndoc-mcp-server
Project-URL: Issues, https://github.com/walidfaour/pwndoc-mcp-server/issues
Author-email: Walid Faour <walid@walidfaour.com>
License-Expression: MIT
Keywords: documentation,mcp,penetration-testing,pentest,pwndoc,security,vulnerability
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Documentation
Requires-Python: >=3.8
Requires-Dist: httpx>=0.25.0
Requires-Dist: pyyaml>=6.0
Provides-Extra: all
Requires-Dist: aiohttp>=3.9.0; extra == 'all'
Requires-Dist: rich>=13.0.0; extra == 'all'
Requires-Dist: typer>=0.9.0; extra == 'all'
Provides-Extra: cli
Requires-Dist: rich>=13.0.0; extra == 'cli'
Requires-Dist: typer>=0.9.0; extra == 'cli'
Provides-Extra: dev
Requires-Dist: aiohttp>=3.9.0; extra == 'dev'
Requires-Dist: black>=23.0.0; extra == 'dev'
Requires-Dist: mypy>=1.0.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: rich>=13.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Requires-Dist: typer>=0.9.0; extra == 'dev'
Requires-Dist: types-pyyaml>=6.0.0; extra == 'dev'
Provides-Extra: sse
Requires-Dist: aiohttp>=3.9.0; extra == 'sse'
Description-Content-Type: text/markdown

# PwnDoc MCP Server - Python

Full-featured Python implementation with pip, Docker, and comprehensive CLI.

See the [main README](../README.md) for complete documentation.

## Quick Start

```bash
# Install
pip install pwndoc-mcp-server[cli]

# Configure
export PWNDOC_URL="https://your-pwndoc.com"
export PWNDOC_TOKEN="your-token"

# Test
pwndoc-mcp test

# Run
pwndoc-mcp serve
```

## Development

```bash
# Install dev dependencies
pip install -e .[dev]

# Run tests
pytest

# Run with coverage
pytest --cov=pwndoc_mcp_server --cov-report=html

# Linting
ruff check src/
black --check src/
mypy src/
```

## Project Structure

```
python/
├── src/pwndoc_mcp_server/
│   ├── __init__.py           # Package init
│   ├── server.py             # MCP server (89 tools)
│   ├── client.py             # PwnDoc API client
│   ├── config.py             # Configuration
│   ├── cli.py                # Rich CLI
│   └── logging_config.py     # Logging
├── tests/                    # Test suite
├── pyproject.toml            # Package config
├── Dockerfile                # Docker build
├── docker-compose.yml        # Docker Compose
└── pytest.ini                # Pytest config
```
