Metadata-Version: 2.4
Name: fastband-mcp
Version: 1.2025.12.5
Summary: Universal AI-powered development platform - AI-agnostic MCP server with adaptive tools, ticket management, and multi-agent coordination
Project-URL: Homepage, https://github.com/RemmyCH3CK/fastband-mcp
Project-URL: Documentation, https://github.com/RemmyCH3CK/fastband-mcp#readme
Project-URL: Repository, https://github.com/RemmyCH3CK/fastband-mcp
Project-URL: Issues, https://github.com/RemmyCH3CK/fastband-mcp/issues
Author: Fastband Team
License-Expression: MIT
License-File: LICENSE
Keywords: ai,automation,claude,development,gemini,mcp,openai,tickets,tools
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
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
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.10
Requires-Dist: httpx>=0.25.0
Requires-Dist: mcp>=0.9.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.0.0
Requires-Dist: typer>=0.9.0
Provides-Extra: all-providers
Requires-Dist: anthropic>=0.18.0; extra == 'all-providers'
Requires-Dist: google-generativeai>=0.3.0; extra == 'all-providers'
Requires-Dist: ollama>=0.1.0; extra == 'all-providers'
Requires-Dist: openai>=1.0.0; extra == 'all-providers'
Provides-Extra: claude
Requires-Dist: anthropic>=0.18.0; extra == 'claude'
Provides-Extra: dev
Requires-Dist: flask>=2.0.0; extra == 'dev'
Requires-Dist: mypy>=1.5.0; extra == 'dev'
Requires-Dist: numpy>=1.24.0; extra == 'dev'
Requires-Dist: pre-commit>=3.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: ruff>=0.1.0; extra == 'dev'
Provides-Extra: full
Requires-Dist: aiofiles>=23.0.0; extra == 'full'
Requires-Dist: anthropic>=0.18.0; extra == 'full'
Requires-Dist: fastapi>=0.100.0; extra == 'full'
Requires-Dist: flask>=2.0.0; extra == 'full'
Requires-Dist: google-generativeai>=0.3.0; extra == 'full'
Requires-Dist: jinja2>=3.0.0; extra == 'full'
Requires-Dist: mypy>=1.5.0; extra == 'full'
Requires-Dist: numpy>=1.24.0; extra == 'full'
Requires-Dist: ollama>=0.1.0; extra == 'full'
Requires-Dist: openai>=1.0.0; extra == 'full'
Requires-Dist: pillow>=10.0.0; extra == 'full'
Requires-Dist: playwright>=1.40.0; extra == 'full'
Requires-Dist: pre-commit>=3.0.0; extra == 'full'
Requires-Dist: psycopg2-binary>=2.9.0; extra == 'full'
Requires-Dist: pymysql>=1.1.0; extra == 'full'
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'full'
Requires-Dist: pytest-cov>=4.0.0; extra == 'full'
Requires-Dist: pytest>=7.0.0; extra == 'full'
Requires-Dist: ruff>=0.1.0; extra == 'full'
Requires-Dist: uvicorn>=0.23.0; extra == 'full'
Requires-Dist: websockets>=11.0.0; extra == 'full'
Provides-Extra: gemini
Requires-Dist: google-generativeai>=0.3.0; extra == 'gemini'
Provides-Extra: hub
Requires-Dist: aiofiles>=23.0.0; extra == 'hub'
Requires-Dist: fastapi>=0.100.0; extra == 'hub'
Requires-Dist: numpy>=1.24.0; extra == 'hub'
Requires-Dist: uvicorn>=0.23.0; extra == 'hub'
Requires-Dist: websockets>=11.0.0; extra == 'hub'
Provides-Extra: mysql
Requires-Dist: pymysql>=1.1.0; extra == 'mysql'
Provides-Extra: ollama
Requires-Dist: ollama>=0.1.0; extra == 'ollama'
Provides-Extra: openai
Requires-Dist: openai>=1.0.0; extra == 'openai'
Provides-Extra: postgres
Requires-Dist: psycopg2-binary>=2.9.0; extra == 'postgres'
Provides-Extra: screenshots
Requires-Dist: pillow>=10.0.0; extra == 'screenshots'
Requires-Dist: playwright>=1.40.0; extra == 'screenshots'
Provides-Extra: web
Requires-Dist: fastapi>=0.100.0; extra == 'web'
Requires-Dist: jinja2>=3.0.0; extra == 'web'
Requires-Dist: uvicorn>=0.23.0; extra == 'web'
Requires-Dist: websockets>=11.0.0; extra == 'web'
Description-Content-Type: text/markdown

# Fastband MCP

**Universal AI-powered development platform** - An AI-agnostic MCP server with adaptive tools, ticket management, and multi-agent coordination.

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![Version](https://img.shields.io/badge/version-v1.2025.12.0--alpha.1-green.svg)](https://github.com/RemmyCH3CK/fastband-mcp/releases)

---

## Vision

> **"A toolbox that travels with you - always the right tools, never too many, ready to grow."**

Fastband MCP transforms AI-assisted development from a project-specific setup into a **universal platform** that:

- Works with **any AI provider** (Claude, OpenAI, Gemini, local LLMs)
- Adapts to **any project type** (web, mobile, desktop, API)
- Scales from **solo developers to enterprise teams**
- Provides **intelligent tool recommendations** based on your project
- Includes **built-in ticket management** that adapts to your workflow
- Enables **multi-agent coordination** for parallel AI workflows

---

## Features

### AI-Agnostic Design
```python
# Switch between providers seamlessly
from fastband import get_provider

claude = get_provider("claude")
openai = get_provider("openai")
local = get_provider("ollama")
```

### Tool Garage System
- **Core tools** always available
- **AI-recommended** tools based on your project
- **Dynamic loading** - add tools as your project grows
- **Performance monitoring** to prevent overload

### Adaptive Ticket Manager
| Project Type | Interface |
|--------------|-----------|
| Web App | CLI + Web Dashboard |
| Desktop App | Embedded Panel (Ctrl+Shift+T) |
| Mobile App | CLI + Companion Web |
| API/Library | CLI only |

### Multi-Agent Coordination
- **Clearance system** for parallel work
- **Hold directives** for critical operations
- **Rebuild announcements** to prevent conflicts

### Automated Backups
- **Change detection** - only backup when needed
- **Multiple database support** - SQLite, PostgreSQL, MySQL
- **Configurable retention** policies

---

## Quick Start

### Installation

```bash
# Basic installation
pip install fastband-mcp

# With Claude support
pip install fastband-mcp[claude]

# With all AI providers
pip install fastband-mcp[all-providers]

# Full installation (all features)
pip install fastband-mcp[full]
```

### Initialize a Project

```bash
cd /your/project
fastband init
```

This launches the setup wizard that will:
1. Detect your project type
2. Recommend AI provider
3. Configure GitHub integration
4. Select appropriate tools
5. Set up ticket management
6. Configure backups

### Basic Commands

```bash
# Check status
fastband status

# List available tools
fastband tools list

# Manage tickets
fastband tickets list
fastband tickets create "Add user authentication"
fastband tickets claim 1 --agent "MCP_Agent1"

# Backup management
fastband backup list
fastband backup create --name "before_refactor"

# Agent coordination
fastband agents status
fastband ops read --since 1h
```

---

## Configuration

Fastband stores configuration in `.fastband/config.yaml`:

```yaml
fastband:
  version: "1.2025.12"

  ai:
    default_provider: "claude"
    providers:
      claude:
        model: "claude-sonnet-4-20250514"
      openai:
        model: "gpt-4-turbo"

  tools:
    max_active: 60
    auto_load_core: true

  tickets:
    enabled: true
    mode: "cli_web"
    web_port: 5050

  backup:
    enabled: true
    daily_retention: 7
    weekly_retention: 4
```

---

## Documentation

- [Getting Started](docs/getting-started/quickstart.md)
- [AI Providers Guide](docs/guides/ai-providers.md)
- [Tool Garage](docs/guides/tool-garage.md)
- [Ticket Manager](docs/guides/ticket-manager.md)
- [Multi-Agent Coordination](docs/guides/coordination.md)
- [API Reference](docs/api/)

---

## Roadmap

### v1.2025.12.0 (Current - Alpha)
- [ ] Core MCP server
- [ ] AI provider abstraction
- [ ] Tool garage system
- [ ] Setup wizard
- [ ] Basic ticket manager

### v1.2026.01.0 (Beta)
- [ ] Full ticket manager with web UI
- [ ] GitHub integration
- [ ] Backup manager
- [ ] Agent ops log

### v1.2026.02.0 (Stable)
- [ ] All features complete
- [ ] Documentation
- [ ] Example projects

---

## Contributing

We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

### Development Setup

```bash
git clone https://github.com/RemmyCH3CK/fastband-mcp
cd fastband-mcp
pip install -e ".[dev]"
pre-commit install
pytest
```

---

## License

MIT License - see [LICENSE](LICENSE) for details.

---

## Acknowledgments

Fastband MCP evolved from the MLB v4.0.1 development platform, incorporating lessons learned from building production AI-assisted development workflows.
