iflow-mcp_bashirk-inbound-mcp 0.1.0__tar.gz

iflow_mcp_bashirk_inbound_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,348 @@
+Metadata-Version: 2.4
+Name: iflow-mcp_bashirk-inbound-mcp
+Version: 0.1.0
+Summary: A production-grade lead generation MCP server using FastMCP, Crawl4AI and external enrichment services
+Author-email: bashirk <hi@kobotai.co>
+License: Apache-2.0
+Project-URL: Homepage, https://github.com/bashirk/inbound-mcp
+Project-URL: Repository, https://github.com/bashirk/inbound-mcp
+Project-URL: Issues, https://github.com/bashirk/inbound-mcp/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: mcp>=1.26.0
+Requires-Dist: crawl4ai>=0.4.3
+Requires-Dist: aiocache>=0.12.0
+Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: uvloop>=0.19.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: pydantic>=2.5.0
+Requires-Dist: playwright>=1.40.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Requires-Dist: pytest-benchmark>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.9.0; extra == "dev"
+Requires-Dist: mypy>=1.5.0; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+Provides-Extra: monitoring
+Requires-Dist: prometheus-client>=0.17.0; extra == "monitoring"
+Requires-Dist: sentry-sdk>=1.30.0; extra == "monitoring"
+Provides-Extra: server
+Requires-Dist: gunicorn>=21.2.0; extra == "server"
+Requires-Dist: uvicorn>=0.23.0; extra == "server"
+
+# Lead Generation Server Documentation
+
+![MCP SDK](https://img.shields.io/badge/MCP_SDK-2.1.0-blue)
+![Crawl4AI](https://img.shields.io/badge/Crawl4AI-0.4.3bx-green)
+![Python](https://img.shields.io/badge/Python-3.10%2B-yellow)
+
+## Table of Contents
+1. [Overview](#overview)
+2. [Features](#features)
+3. [Architecture](#architecture)
+4. [Prerequisites](#prerequisites)
+5. [Installation](#installation)
+6. [Configuration](#configuration)
+7. [Running the Server](#running-the-server)
+8. [API Documentation](#api-documentation)
+9. [Examples](#examples)
+10. [Advanced Configuration](#advanced-configuration)
+11. [Troubleshooting](#troubleshooting)
+12. [Contributing](#contributing)
+13. [License](#license)
+14. [Roadmap](#roadmap)
+15. [Support](#support)
+
+---
+
+## Overview <a name="overview"></a>
+A production-grade lead generation system built on:
+- **MCP Python SDK** for protocol-compliant AI services
+- **Crawl4AI** for intelligent web crawling
+- **AsyncIO** for high-concurrency operations
+
+Implements a full lead lifecycle from discovery to enrichment with:
+- UUID-based lead tracking
+- Multi-source data aggregation
+- Smart caching strategies
+- Enterprise-grade error handling
+
+---
+
+## Features <a name="features"></a>
+| Feature | Tech Stack | Throughput |
+|---------|------------|------------|
+| Lead Generation | Google CSE, Crawl4AI | 120 req/min |
+| Data Enrichment | Hunter.io, Clearbit [Hubspot Breeze] | 80 req/min |
+| LinkedIn Scraping | Playwright, Stealth Mode | 40 req/min |
+| Caching | aiocache, Redis | 10K ops/sec |
+| Monitoring | Prometheus, Custom Metrics | Real-time |
+
+---
+
+## Architecture <a name="architecture"></a>
+```mermaid
+graph TD
+    A[Client] --> B[MCP Server]
+    B --> C{Lead Manager}
+    C --> D[Google CSE]
+    C --> E[Crawl4AI]
+    C --> F[Hunter.io]
+    C --> G[Clearbit]
+    C --> H[LinkedIn Scraper]
+    C --> I[(Redis Cache)]
+    C --> J[Lead Store]
+```
+
+---
+
+## Prerequisites <a name="prerequisites"></a>
+- Python 3.10+
+- API Keys:
+  ```bash
+  export HUNTER_API_KEY="your_key"
+  export CLEARBIT_API_KEY="your_key"
+  export GOOGLE_CSE_ID="your_id"
+  export GOOGLE_API_KEY="your_key"
+  ```
+- LinkedIn Session Cookie (for scraping)
+- 4GB+ RAM (8GB recommended for heavy scraping)
+
+---
+
+## Installation <a name="installation"></a>
+
+### Production Setup
+```bash
+# Create virtual environment
+python -m venv .venv && source .venv/bin/activate
+
+# Install with production dependencies
+pip install mcp crawl4ai[all] aiocache aiohttp uvloop
+
+# Set up browser dependencies
+python -m playwright install chromium
+```
+
+### Docker Deployment
+```dockerfile
+FROM python:3.10-slim
+
+RUN apt-get update && apt-get install -y \
+    gcc \
+    libpython3-dev \
+    chromium \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY . /app
+WORKDIR /app
+
+RUN pip install --no-cache-dir -r requirements.txt
+CMD ["python", "-m", "mcp", "run", "lead_server.py"]
+```
+
+---
+
+## Configuration <a name="configuration"></a>
+`config.yaml`
+```yaml
+services:
+  hunter:
+    api_key: ${HUNTER_API_KEY}
+    rate_limit: 50/60s
+    
+  clearbit:
+    api_key: ${CLEARBIT_API_KEY}
+    cache_ttl: 86400
+
+scraping:
+  stealth_mode: true
+  headless: true
+  timeout: 30
+  max_retries: 3
+
+cache:
+  backend: redis://localhost:6379/0
+  default_ttl: 3600
+```
+
+---
+
+## Running the Server <a name="running-the-server"></a>
+
+### Development Mode
+```bash
+mcp dev lead_server.py --reload --port 8080
+```
+
+### Production
+```bash
+gunicorn -w 4 -k uvicorn.workers.UvicornWorker lead_server:app
+```
+
+### Docker
+```bash
+docker build -t lead-server .
+docker run -p 8080:8080 -e HUNTER_API_KEY=your_key lead-server
+```
+
+---
+
+## API Documentation <a name="api-documentation"></a>
+
+### 1. Generate Lead
+```http
+POST /tools/lead_generation
+Content-Type: application/json
+
+{
+  "search_terms": "OpenAI"
+}
+```
+
+Response:
+```json
+{
+  "lead_id": "550e8400-e29b-41d4-a716-446655440000",
+  "status": "pending",
+  "estimated_time": 15
+}
+```
+
+### 2. Enrich Lead
+```http
+POST /tools/data_enrichment
+Content-Type: application/json
+
+{
+  "lead_id": "550e8400-e29b-41d4-a716-446655440000"
+}
+```
+
+### 3. Monitor Leads
+```http
+GET /tools/lead_maintenance
+```
+
+---
+
+## Examples <a name="examples"></a>
+
+### Python Client
+```python
+from mcp.client import Client
+
+async with Client() as client:
+    # Generate lead
+    lead = await client.call_tool(
+        "lead_generation",
+        {"search_terms": "Anthropic"}
+    )
+    
+    # Enrich with all services
+    enriched = await client.call_tool(
+        "data_enrichment",
+        {"lead_id": lead['lead_id']}
+    )
+    
+    # Get full lead data
+    status = await client.call_tool(
+        "lead_status",
+        {"lead_id": lead['lead_id']}
+    )
+```
+
+### cURL
+```bash
+# Generate lead
+curl -X POST http://localhost:8080/tools/lead_generation \
+  -H "Content-Type: application/json" \
+  -d '{"search_terms": "Cohere AI"}'
+```
+
+---
+
+## Advanced Configuration <a name="advanced-configuration"></a>
+
+### Caching Strategies
+```python
+from aiocache import Cache
+
+# Configure Redis cluster
+Cache.from_url(
+    "redis://cluster-node1:6379/0",
+    timeout=10,
+    retry=True,
+    retry_timeout=2
+)
+```
+
+### Rate Limiting
+```python
+from mcp.server.middleware import RateLimiter
+
+mcp.add_middleware(
+    RateLimiter(
+        rules={
+            "lead_generation": "100/1m",
+            "data_enrichment": "50/1m"
+        }
+    )
+)
+```
+
+---
+
+## Troubleshooting <a name="troubleshooting"></a>
+
+| Error | Solution |
+|-------|----------|
+| `403 Forbidden` from Google | Rotate IPs or use official CSE API |
+| `429 Too Many Requests` | Implement exponential backoff |
+| `Playwright Timeout` | Increase `scraping.timeout` in config |
+| `Cache Miss` | Verify Redis connection and TTL settings |
+
+---
+
+## Contributing <a name="contributing"></a>
+1. Fork the repository
+2. Create feature branch: `git checkout -b feature/new-enrichment`
+3. Commit changes: `git commit -am 'Add Clearbit alternative'`
+4. Push to branch: `git push origin feature/new-enrichment`
+5. Submit pull request
+
+---
+
+## License <a name="license"></a>
+Apache 2.0 - See [LICENSE](LICENSE) for details.
+
+---
+
+## Roadmap <a name="roadmap"></a>
+- [ ] **Q2 2025**: AI-powered lead scoring
+- [ ] **Q3 2025**: Distributed crawling cluster support
+
+---
+
+## Support <a name="support"></a>
+For enterprise support and custom integrations:  
+📧 Email: [hi@kobotai.co](mailto:support@leadgen.ai)  
+🐦 Twitter: [@KobotAIco](https://x.com/KobotAIco)
+
+---
+
+```bash
+# Run benchmark tests
+pytest tests/ --benchmark-json=results.json
+```
+
+![Benchmark Results](https://via.placeholder.com/800x400.png?text=Performance+Metrics)

iflow_mcp_bashirk_inbound_mcp-0.1.0/ReadMe.MD

@@ -0,0 +1,307 @@
+# Lead Generation Server Documentation
+
+![MCP SDK](https://img.shields.io/badge/MCP_SDK-2.1.0-blue)
+![Crawl4AI](https://img.shields.io/badge/Crawl4AI-0.4.3bx-green)
+![Python](https://img.shields.io/badge/Python-3.10%2B-yellow)
+
+## Table of Contents
+1. [Overview](#overview)
+2. [Features](#features)
+3. [Architecture](#architecture)
+4. [Prerequisites](#prerequisites)
+5. [Installation](#installation)
+6. [Configuration](#configuration)
+7. [Running the Server](#running-the-server)
+8. [API Documentation](#api-documentation)
+9. [Examples](#examples)
+10. [Advanced Configuration](#advanced-configuration)
+11. [Troubleshooting](#troubleshooting)
+12. [Contributing](#contributing)
+13. [License](#license)
+14. [Roadmap](#roadmap)
+15. [Support](#support)
+
+---
+
+## Overview <a name="overview"></a>
+A production-grade lead generation system built on:
+- **MCP Python SDK** for protocol-compliant AI services
+- **Crawl4AI** for intelligent web crawling
+- **AsyncIO** for high-concurrency operations
+
+Implements a full lead lifecycle from discovery to enrichment with:
+- UUID-based lead tracking
+- Multi-source data aggregation
+- Smart caching strategies
+- Enterprise-grade error handling
+
+---
+
+## Features <a name="features"></a>
+| Feature | Tech Stack | Throughput |
+|---------|------------|------------|
+| Lead Generation | Google CSE, Crawl4AI | 120 req/min |
+| Data Enrichment | Hunter.io, Clearbit [Hubspot Breeze] | 80 req/min |
+| LinkedIn Scraping | Playwright, Stealth Mode | 40 req/min |
+| Caching | aiocache, Redis | 10K ops/sec |
+| Monitoring | Prometheus, Custom Metrics | Real-time |
+
+---
+
+## Architecture <a name="architecture"></a>
+```mermaid
+graph TD
+    A[Client] --> B[MCP Server]
+    B --> C{Lead Manager}
+    C --> D[Google CSE]
+    C --> E[Crawl4AI]
+    C --> F[Hunter.io]
+    C --> G[Clearbit]
+    C --> H[LinkedIn Scraper]
+    C --> I[(Redis Cache)]
+    C --> J[Lead Store]
+```
+
+---
+
+## Prerequisites <a name="prerequisites"></a>
+- Python 3.10+
+- API Keys:
+  ```bash
+  export HUNTER_API_KEY="your_key"
+  export CLEARBIT_API_KEY="your_key"
+  export GOOGLE_CSE_ID="your_id"
+  export GOOGLE_API_KEY="your_key"
+  ```
+- LinkedIn Session Cookie (for scraping)
+- 4GB+ RAM (8GB recommended for heavy scraping)
+
+---
+
+## Installation <a name="installation"></a>
+
+### Production Setup
+```bash
+# Create virtual environment
+python -m venv .venv && source .venv/bin/activate
+
+# Install with production dependencies
+pip install mcp crawl4ai[all] aiocache aiohttp uvloop
+
+# Set up browser dependencies
+python -m playwright install chromium
+```
+
+### Docker Deployment
+```dockerfile
+FROM python:3.10-slim
+
+RUN apt-get update && apt-get install -y \
+    gcc \
+    libpython3-dev \
+    chromium \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY . /app
+WORKDIR /app
+
+RUN pip install --no-cache-dir -r requirements.txt
+CMD ["python", "-m", "mcp", "run", "lead_server.py"]
+```
+
+---
+
+## Configuration <a name="configuration"></a>
+`config.yaml`
+```yaml
+services:
+  hunter:
+    api_key: ${HUNTER_API_KEY}
+    rate_limit: 50/60s
+    
+  clearbit:
+    api_key: ${CLEARBIT_API_KEY}
+    cache_ttl: 86400
+
+scraping:
+  stealth_mode: true
+  headless: true
+  timeout: 30
+  max_retries: 3
+
+cache:
+  backend: redis://localhost:6379/0
+  default_ttl: 3600
+```
+
+---
+
+## Running the Server <a name="running-the-server"></a>
+
+### Development Mode
+```bash
+mcp dev lead_server.py --reload --port 8080
+```
+
+### Production
+```bash
+gunicorn -w 4 -k uvicorn.workers.UvicornWorker lead_server:app
+```
+
+### Docker
+```bash
+docker build -t lead-server .
+docker run -p 8080:8080 -e HUNTER_API_KEY=your_key lead-server
+```
+
+---
+
+## API Documentation <a name="api-documentation"></a>
+
+### 1. Generate Lead
+```http
+POST /tools/lead_generation
+Content-Type: application/json
+
+{
+  "search_terms": "OpenAI"
+}
+```
+
+Response:
+```json
+{
+  "lead_id": "550e8400-e29b-41d4-a716-446655440000",
+  "status": "pending",
+  "estimated_time": 15
+}
+```
+
+### 2. Enrich Lead
+```http
+POST /tools/data_enrichment
+Content-Type: application/json
+
+{
+  "lead_id": "550e8400-e29b-41d4-a716-446655440000"
+}
+```
+
+### 3. Monitor Leads
+```http
+GET /tools/lead_maintenance
+```
+
+---
+
+## Examples <a name="examples"></a>
+
+### Python Client
+```python
+from mcp.client import Client
+
+async with Client() as client:
+    # Generate lead
+    lead = await client.call_tool(
+        "lead_generation",
+        {"search_terms": "Anthropic"}
+    )
+    
+    # Enrich with all services
+    enriched = await client.call_tool(
+        "data_enrichment",
+        {"lead_id": lead['lead_id']}
+    )
+    
+    # Get full lead data
+    status = await client.call_tool(
+        "lead_status",
+        {"lead_id": lead['lead_id']}
+    )
+```
+
+### cURL
+```bash
+# Generate lead
+curl -X POST http://localhost:8080/tools/lead_generation \
+  -H "Content-Type: application/json" \
+  -d '{"search_terms": "Cohere AI"}'
+```
+
+---
+
+## Advanced Configuration <a name="advanced-configuration"></a>
+
+### Caching Strategies
+```python
+from aiocache import Cache
+
+# Configure Redis cluster
+Cache.from_url(
+    "redis://cluster-node1:6379/0",
+    timeout=10,
+    retry=True,
+    retry_timeout=2
+)
+```
+
+### Rate Limiting
+```python
+from mcp.server.middleware import RateLimiter
+
+mcp.add_middleware(
+    RateLimiter(
+        rules={
+            "lead_generation": "100/1m",
+            "data_enrichment": "50/1m"
+        }
+    )
+)
+```
+
+---
+
+## Troubleshooting <a name="troubleshooting"></a>
+
+| Error | Solution |
+|-------|----------|
+| `403 Forbidden` from Google | Rotate IPs or use official CSE API |
+| `429 Too Many Requests` | Implement exponential backoff |
+| `Playwright Timeout` | Increase `scraping.timeout` in config |
+| `Cache Miss` | Verify Redis connection and TTL settings |
+
+---
+
+## Contributing <a name="contributing"></a>
+1. Fork the repository
+2. Create feature branch: `git checkout -b feature/new-enrichment`
+3. Commit changes: `git commit -am 'Add Clearbit alternative'`
+4. Push to branch: `git push origin feature/new-enrichment`
+5. Submit pull request
+
+---
+
+## License <a name="license"></a>
+Apache 2.0 - See [LICENSE](LICENSE) for details.
+
+---
+
+## Roadmap <a name="roadmap"></a>
+- [ ] **Q2 2025**: AI-powered lead scoring
+- [ ] **Q3 2025**: Distributed crawling cluster support
+
+---
+
+## Support <a name="support"></a>
+For enterprise support and custom integrations:  
+📧 Email: [hi@kobotai.co](mailto:support@leadgen.ai)  
+🐦 Twitter: [@KobotAIco](https://x.com/KobotAIco)
+
+---
+
+```bash
+# Run benchmark tests
+pytest tests/ --benchmark-json=results.json
+```
+
+![Benchmark Results](https://via.placeholder.com/800x400.png?text=Performance+Metrics)