Metadata-Version: 2.4
Name: aceflow-mcp-server
Version: 2.1.5
Summary: AceFlow MCP Server - AI-协作增强版，支持双向AI-MCP数据交换的智能开发工作流服务器，支持HTTP和stdio传输模式
Author-email: AceFlow Team <team@aceflow.dev>
Maintainer-email: AceFlow Team <team@aceflow.dev>
License: MIT
Project-URL: Homepage, https://github.com/aceflow-pateoas/aceflow-ai
Project-URL: Documentation, https://docs.aceflow.dev/mcp
Project-URL: Repository, https://github.com/aceflow-pateoas/aceflow-ai.git
Project-URL: Issues, https://github.com/aceflow-pateoas/aceflow-ai/issues
Keywords: mcp,model-context-protocol,workflow,ai-collaboration,ai-tools,dual-direction,intelligent-workflow,claude-code,cursor
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
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 :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=1.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: click>=8.0.0
Requires-Dist: rich>=13.0.0
Requires-Dist: psutil>=5.9.0
Requires-Dist: aiofiles>=23.0.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: jinja2>=3.0.0
Requires-Dist: pyyaml>=6.0.0
Requires-Dist: fastapi>=0.104.0
Requires-Dist: uvicorn[standard]>=0.24.0
Requires-Dist: starlette>=0.27.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: isort>=5.0.0; extra == "dev"
Requires-Dist: flake8>=6.0.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Provides-Extra: performance
Requires-Dist: uvloop>=0.17.0; extra == "performance"
Requires-Dist: orjson>=3.8.0; extra == "performance"
Provides-Extra: monitoring
Requires-Dist: prometheus-client>=0.16.0; extra == "monitoring"
Requires-Dist: structlog>=22.0.0; extra == "monitoring"
Provides-Extra: all
Requires-Dist: aceflow-mcp-server[dev,monitoring,performance]; extra == "all"
Dynamic: license-file

# AceFlow MCP Server

AI-driven workflow management through Model Context Protocol.

## 📁 Project Structure

```
aceflow-mcp-server/
├── aceflow_mcp_server/          # Core package directory
│   ├── core/                    # Core functionality modules
│   ├── main.py                  # Main entry point
│   ├── tools.py                 # Tool implementations
│   └── ...
├── tests/                       # Formal test suite
├── examples/                    # Examples and demo code
├── scripts/                     # Build and deployment scripts
│   ├── build/                   # Build-related scripts
│   ├── deploy/                  # Deployment scripts
│   └── dev/                     # Development tools
├── docs/                        # Documentation
│   ├── user-guide/              # User guides
│   ├── developer-guide/         # Developer guides
│   └── project/                 # Project documentation
├── dev-tests/                   # Development tests and experiments
└── pyproject.toml               # Project configuration
```

## Overview

AceFlow MCP Server provides structured software development workflows through the Model Context Protocol (MCP), enabling AI clients like Kiro, Cursor, and Claude to manage projects with standardized processes.

## Features

### 🛠️ MCP Tools
- **aceflow_init**: Initialize projects with different workflow modes
- **aceflow_stage**: Manage project stages and workflow progression  
- **aceflow_validate**: Validate project compliance and quality
- **aceflow_template**: Manage workflow templates

### 📊 MCP Resources
- **aceflow://project/state**: Current project state and progress
- **aceflow://workflow/config**: Workflow configuration and settings
- **aceflow://stage/guide/{stage}**: Stage-specific guidance and instructions

### 🤖 MCP Prompts
- **workflow_assistant**: Context-aware workflow guidance
- **stage_guide**: Stage-specific assistance and best practices

## Quick Start

### Installation

```bash
# Method 1: Install via uvx (recommended for end users)
uvx aceflow-mcp-server

# Method 2: Install via pip (traditional method)
pip install aceflow-mcp-server

# Method 3: Install with optional features
pip install aceflow-mcp-server[performance,monitoring]
```

### MCP Client Configuration

#### For uvx installation:
```json
{
  "mcpServers": {
    "aceflow": {
      "command": "uvx",
      "args": ["aceflow-mcp-server@latest"],
      "env": {
        "ACEFLOW_LOG_LEVEL": "INFO"
      }
    }
  }
}
```

#### For pip installation:
```json
{
  "mcpServers": {
    "aceflow": {
      "command": "aceflow-mcp-server",
      "args": [],
      "env": {
        "ACEFLOW_LOG_LEVEL": "INFO"
      }
    }
  }
}
```

### Usage Example

```
User: "I want to start a new AI project with standard workflow"

AI: I'll help you initialize a new project using AceFlow.

[Uses aceflow_init tool]
✅ Project initialized successfully in standard mode!

Current status:
- Project: ai-project
- Mode: STANDARD
- Stage: user_stories (0% complete)

Ready to begin with user story analysis. Would you like guidance for this stage?
```

## Workflow Modes

### Minimal Mode
Fast prototyping and concept validation
- 3 stages: Implementation → Test → Demo
- Ideal for MVPs and quick experiments

### Standard Mode  
Traditional software development workflow
- 8 stages: User Stories → Task Breakdown → Test Design → Implementation → Unit Test → Integration Test → Code Review → Demo
- Balanced approach for most projects

### Complete Mode
Enterprise-grade development process
- 12 stages: Full requirements analysis through security review
- Comprehensive quality gates and documentation

### Smart Mode
AI-enhanced adaptive workflow
- 10 stages with intelligent adaptation
- Dynamic complexity assessment and optimization

## Architecture

```
┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   AI Client     │    │  MCP Server     │    │  AceFlow Core   │
│  (Kiro/Cursor)  │◄──►│   (FastMCP)     │◄──►│    Engine       │
└─────────────────┘    └─────────────────┘    └─────────────────┘
                              │
                              ▼
                       ┌─────────────────┐
                       │  File System    │
                       │ (.aceflow/...)  │
                       └─────────────────┘
```

## Development

### Setup

```bash
# Clone repository
git clone https://github.com/aceflow/aceflow-mcp-server
cd aceflow-mcp-server

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run with coverage
pytest --cov=aceflow_mcp_server
```

### Project Structure

```
aceflow-mcp-server/
├── aceflow_mcp_server/
│   ├── __init__.py
│   ├── server.py          # Main MCP server
│   ├── tools.py           # MCP tools implementation
│   ├── resources.py       # MCP resources
│   ├── prompts.py         # MCP prompts
│   └── core/              # Core functionality
├── tests/                 # Test suite
├── docs/                  # Documentation
└── pyproject.toml         # Project configuration
```

## Contributing

1. Fork the repository
2. Create a feature branch
3. Add tests for new functionality
4. Ensure all tests pass
5. Submit a pull request

## License

MIT License - see LICENSE file for details.

## Support

- **Documentation**: https://docs.aceflow.dev/mcp
- **Issues**: https://github.com/aceflow/aceflow-mcp-server/issues
- **Discussions**: https://github.com/aceflow/aceflow-mcp-server/discussions

---

*Generated by AceFlow v3.0 MCP Server*
