Metadata-Version: 2.4
Name: wpipe-mcp
Version: 0.1.1
Summary: MCP Server for WPipe Architecting
Author-email: "William Rodriguez (wisrovi)" <wisrovi.rodriguez@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/wisrovi/wpipe-mcp
Project-URL: Repository, https://github.com/wisrovi/wpipe-mcp.git
Project-URL: Issues, https://github.com/wisrovi/wpipe-mcp/issues
Keywords: mcp,wpipe,pipeline,orchestration,ai,agent
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Intended Audience :: Developers
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp[cli]>=1.0.0
Requires-Dist: fastmcp>=0.1.0
Requires-Dist: pydantic>=2.0.0
Dynamic: license-file

# 🦅 wpipe-mcp

[![Version](https://img.shields.io/badge/version-0.1.0-blue.svg)](https://github.com/wisrovi/wpipe-mcp)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![MCP](https://img.shields.io/badge/MCP-1.0-orange.svg)](https://modelcontextprotocol.io)

**Transform your AI Agents into expert WPipe Architects.**

`wpipe-mcp` is a professional Model Context Protocol (MCP) server that bridges the gap between AI Agents (Claude, Gemini, OpenCode) and the **wisrovi SUITE**. It empowers agents to search, design, and deploy high-performance pipelines following industry-standard patterns.

---

## ✨ Key Features

- **🔍 Expert Catalog Search**: Query over 100+ production-ready steps from Official and Community registries.
- **🏗️ Professional Scaffolding**: Deploy complete project structures with LTS patterns (Class-based states, Typed Context, Pydantic).
- **📘 Architect's Manual**: Built-in expertise that teaches agents how to build pipelines exactly like a Senior Engineer.
- **💻 Unified CLI**: Manage your MCP service with simple commands: `run`, `start`, `stop`, and `config`.
- **🛡️ Privacy First**: 100% local execution via `stdio` or `SSE`.

---

## 🚀 Quick Start

### 1. Installation
Clone the repository and run the automated installer:
```bash
./installer.sh
```

### 2. Integration
Get your agent-specific configuration block:
```bash
wpipe-mcp config
```
Copy the output into your agent's configuration file (e.g., `claude_desktop_config.json`).

---

## 🛠️ CLI Usage

| Command | Description |
| :--- | :--- |
| `wpipe-mcp run` | Start the server in `stdio` mode (default for agents). |
| `wpipe-mcp start` | Start as an SSE server in the background. |
| `wpipe-mcp stop` | Stop the background server. |
| `wpipe-mcp config` | Generate JSON configuration for AI agents. |
| `wpipe-mcp help` | Show available tools and commands. |

---

## 📂 Project Structure
- `src/wpipe_mcp/`: Core server logic and tools.
- `src/wpipe_mcp/catalog.py`: Real-time GitHub catalog synchronization.
- `src/wpipe_mcp/templates.py`: Professional boilerplate definitions.
- `examples/`: Sample implementations and use cases.

---

## 📄 License
MIT License - Crafted with ❤️ by **William Rodriguez** (wisrovi).
