io.github.4rgon4ut/sutra
Context Engineering Engine. Provides cognitive tools, memory structures, and agent patterns.
Open source Open in the app JSON README (API)
About
Context Engineering Engine. Provides cognitive tools, memory structures, and agent patterns.
Details
- Kind
- MCP servers
- Topic
- AI, RAG & memory
- Publisher
- 4rgon4ut
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.1
- Last push
- 2026-01-03T11:35:41Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-29 03:01:38
- Updated
- 2026-08-29 03:01:38
- Origin id
io.github.4rgon4ut/sutra
README
# Sutra
mcp-name: io.github.4rgon4ut/sutra
**The MCP Context Engineering Engine**
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
Select your agent below and copy-paste the config.
<details>
<summary>Claude Desktop</summary>
Add to `claude_desktop_config.json`:
```json
{
"mcpServers": {
"sutra": {
"command": "uv",
"args": ["tool", "run", "context-engineering-mcp"]
}
}
}
```
</details>
<details>
<summary>Claude Code</summary>
Run this in your terminal:
```bash
claude mcp add sutra uv tool run context-engineering-mcp
```
</details>
<details>
<summary>Aider</summary>
Run aider with the mcp flag:
```bash
aider --mcp "uv tool run context-engineering-mcp"
```
Or add to `.aider.conf.yml`:
```yaml
mcp: ["uv tool run context-engineering-mcp"]
```
</details>
<details>
<summary>Gemini CLI</summary>
Add to `~/.gemini/settings.json`:
```json
{
"mcpServers": {
"sutra": {
"command": "uv",
"args": ["tool", "run", "context-engineering-mcp"]
}
}
}
```
</details>
<details>
<summary>Cursor / Windsurf</summary>
In MCP settings, add a new server:
- **Name**: Sutra
- **Type**: command
- **Command**: `uv tool run context-engineering-mcp`
</details>
<details>
<summary>Codex</summary>
Add to your config (TOML):
```toml
[mcp_servers.sutra]
command = "uv"
args = ["tool", "run", "context-engineering-mcp"]
```
</details>
## 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