Metadata-Version: 2.4
Name: context-engineering-mcp
Version: 0.1.0
Summary: MCP server for Context Engineering templates and protocols
License-File: LICENSE
Requires-Python: >=3.10
Requires-Dist: mcp>=1.0.0
Requires-Dist: pydantic>=2.0.0
Provides-Extra: dev
Requires-Dist: mypy>=1.0.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Description-Content-Type: text/markdown

# Sutra

**The Context Engineering Engine for MCP**

Sutra is a Model Context Protocol (MCP) server that transforms how LLMs handle reasoning, memory, and orchestration. It provides a "Standard Library" of cognitive tools (Thinking Models), memory structures (Cells), and multi-agent patterns (Organs).

## 🚀 Installation

### Using `uv` (Recommended)
```bash
uv tool install context-engineering-mcp
```

### Using `pip`
```bash
pip install context-engineering-mcp
```

## ⚙️ Configuration

### Claude Desktop
Add to your `claude_desktop_config.json`:
```json
{
  "mcpServers": {
    "sutra": {
      "command": "uv",
      "args": ["tool", "run", "context-engineering-mcp"]
    }
  }
}
```

### Cursor / Windsurf
Add to your MCP settings:
- **Type**: Command
- **Command**: `uv`
- **Args**: `tool run context-engineering-mcp`

## 🧠 Core Features (v0.1.0)

### 1. The Gateway (Router)
Sutra automatically analyzes your request to decide the best strategy:
- **YOLO Mode**: For immediate tasks ("Fix this bug"), it routes to specific cognitive tools.
- **Constructor Mode**: For system design ("Build a bot"), it routes to the Architect.

### 2. The Architect
Generates blueprints for custom agents, combining:
- **Thinking Models**: `understand_question`, `verify_logic`, `backtracking`, `symbolic_abstract`.
- **Memory Cells**: `key_value` (State), `windowed` (Short-term), `episodic` (Long-term).
- **Organs**: `debate_council` (Multi-perspective), `research_synthesis` (Deep Dive).

### 3. The Librarian
A manual discovery tool (`get_technique_guide`) that lets you or the agent browse the full catalog of Context Engineering techniques.

## 🛠️ Development

**Requirements**: Python 3.10+, `uv` (optional but recommended).

1. Clone the repo:
   ```bash
   git clone https://github.com/4rgon4ut/sutra.git
   cd sutra
   ```
2. Install dependencies:
   ```bash
   uv sync --all-extras
   # OR
   pip install -e ".[dev]"
   ```
3. Run tests:
   ```bash
   pytest
   ```

## 📄 License
MIT