Metadata-Version: 2.4
Name: gd-specflow
Version: 0.7.1
Summary: SpecFlow MCP Server and CLI — spec-driven AI code generation
Author-email: Adam Wrobel <awrobel@griddynamics.com>, Artsiom Kozak <akozak@griddynamics.com>, Mateusz Konopelski <mkonopelski@griddynamics.com>
License: MIT
Project-URL: Homepage, https://github.com/griddynamics/specflow
Project-URL: Documentation, https://github.com/griddynamics/specflow/blob/main/README.md
Project-URL: Repository, https://github.com/griddynamics/specflow
Keywords: mcp,ai,code-generation,specflow,llm,claude
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: ==3.13.*
Description-Content-Type: text/markdown
Requires-Dist: fastmcp>=0.2.0
Requires-Dist: httpx>=0.26.0
Requires-Dist: pydantic>=2.5.3
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: python-docx>=1.1.0
Requires-Dist: python-pptx>=1.0.0
Requires-Dist: openpyxl>=3.1.0
Requires-Dist: plyer>=2.1.0; sys_platform != "darwin"
Requires-Dist: plyer[macosx]>=2.1.0; sys_platform == "darwin"
Requires-Dist: pypdf>=5.0
Requires-Dist: pillow>=12.2.0
Requires-Dist: textual>=0.60

# gd-specflow

SpecFlow MCP server and CLI — spec-driven AI code generation from your IDE.

SpecFlow is an agent harness that automates specification analysis, implementation planning, and large-scale parallel code generation. This package provides the MCP server (`specflow-mcp`) and the terminal UI (`specflow tui`).

Requires **Python 3.13**, **Docker**, and **`uv`** ([install](https://github.com/astral-sh/uv)).

## Local agentic harness sandbox setup

Codegen runs against a **local Docker backend** in the main SpecFlow repository — installing this package alone is not enough.

Entry point: **[README.md](https://github.com/griddynamics/specflow/blob/main/README.md)** 

Short instructions:

1. Clone the repo and enter it:

   ```bash
   git clone https://github.com/griddynamics/specflow.git
   cd specflow
   ```

2. Install Specflow (includes the Terminal UI that guides you through onboarding)
   ```bash
   uv tool install --editable "./mcp_server"
   ```

4. Bootstrap the sandbox - interactive wizard

   ```bash
   specflow tui
   ```


## MCP tools

| Tool | Description |
| --- | --- |
| `check_specification_completeness` | Analyze specs for gaps and contradictions (local) |
| `run_planning` | Generate a phased implementation plan (local) |
| `read_document` | Extract PDF/DOCX/PPTX/XLSX/CSV to markdown (local) |
| `run_generation` | Upload and launch parallel codegen on the backend |
| `check_status` | Poll generation progress |
| `download_outputs` | Download artifacts from a completed run |
| `retry_generation` | Retry a failed generation |

## Documentation

- [Repository & overview](https://github.com/griddynamics/specflow)
- [Local quickstart](https://github.com/griddynamics/specflow/blob/main/QUICKSTART.md)
- [MCP setup guide](https://github.com/griddynamics/specflow/blob/main/MCP_USER.md)
- [MCP API reference](https://github.com/griddynamics/specflow/blob/main/docs/mcp/API_REFERENCE.md)

## License

MIT — Copyright (c) 2024 Grid Dynamics International, Inc.
