<!-- mcp-name: io.github.AMEOBIUS-space/mcp-tools-bundle -->

# MCP Tools Bundle — 3 Zero-Dependency MCP Servers in Pure Python

[![Tests](https://img.shields.io/badge/tests-105%20passing-brightgreen)](https://github.com/AMEOBIUS-space/mcp-tools-bundle)
[![PyPI](https://img.shields.io/pypi/v/mcp-tools-bundle)](https://pypi.org/project/mcp-tools-bundle/)
[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
[![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://python.org)
[![Dependencies](https://img.shields.io/badge/dependencies-zero-success)](https://github.com/AMEOBIUS-space/mcp-tools-bundle)
[![MCP](https://img.shields.io/badge/MCP-compatible-orange)](https://modelcontextprotocol.io)

> Three production-ready MCP (Model Context Protocol) servers for AI agents. Zero pip dependencies. Pure Python standard library.

Official registry draft: [`server.json`](server.json) (`io.github.AMEOBIUS-space/mcp-tools-bundle`). LO submits via `mcp-publisher` after PyPI includes this README marker.

## Servers

| Server | Tools | Entry point |
|--------|-------|-------------|
| **mcp-cdp-scraper** | 12 | `mcp-cdp-scraper` |
| **mcp-crypto-monitor** | 10 | `mcp-crypto-monitor` |
| **mcp-email-sender** | 8 | `mcp-email-sender` |
| **Total** | **30** | |

## Requirements

- **Python 3.10+**
- Network for crypto/scraper tools as needed
- No runtime pip deps beyond the stdlib

## Installation

```bash
pip install mcp-tools-bundle
```

From source:

```bash
git clone https://github.com/AMEOBIUS-space/mcp-tools-bundle.git
cd mcp-tools-bundle
pip install -e .
```

Verify:

```bash
mcp-cdp-scraper --manifest
mcp-crypto-monitor --manifest
mcp-email-sender --manifest
```

## Running a Server

```bash
mcp-cdp-scraper --stdio
mcp-crypto-monitor --stdio
mcp-email-sender --stdio
```

## Client Integration

### Claude Desktop / Hermes

```json
{
  "mcpServers": {
    "cdp-scraper": {
      "command": "mcp-cdp-scraper",
      "args": ["--stdio"]
    },
    "crypto-monitor": {
      "command": "mcp-crypto-monitor",
      "args": ["--stdio"]
    },
    "email-sender": {
      "command": "mcp-email-sender",
      "args": ["--stdio"],
      "env": {
        "SMTP_HOST": "smtp.gmail.com",
        "SMTP_PORT": "587",
        "SMTP_USERNAME": "your@gmail.com",
        "SMTP_PASSWORD": "your-app-password",
        "SMTP_TLS": "true"
      }
    }
  }
}
```

## Server Reference

### mcp-cdp-scraper

Chrome DevTools Protocol scrape/fill/screenshot tools. Zero Playwright/Selenium.

### mcp-crypto-monitor

Public APIs for balances/prices (Blockchain.info, Etherscan, CoinGecko, Binance, alternative.me).

### mcp-email-sender

Validate emails + SMTP send. Configure via `SMTP_*` env vars.

## Architecture

```
MCP Client → STDIO JSON-RPC → MCPServer → engine modules → Chrome / public APIs / SMTP
```

## Testing

```bash
pip install pytest
python -m pytest tests/ -q
```

## Registry submit (LO only)

1. Merge this PR and publish a PyPI version that includes the `mcp-name` HTML comment above.
2. `mcp-publisher login github` (namespace `io.github.AMEOBIUS-space`)
3. `mcp-publisher publish` from repo root using `server.json`

## License

MIT — see [LICENSE](LICENSE).

## Links

- [GitHub](https://github.com/AMEOBIUS-space/mcp-tools-bundle)
- [PyPI](https://pypi.org/project/mcp-tools-bundle/)
- [cdp-toolkit](https://github.com/AMEOBIUS-space/cdp-toolkit) (related CDP client)
- Portfolio: [darkbot-ai-templates](https://github.com/AMEOBIUS-space/darkbot-ai-templates)
- Freelance: [kwork-portfolio](https://ameobius-space.github.io/kwork-portfolio/)