📦

io.github.4rgon4ut/sutra

Context Engineering Engine. Provides cognitive tools, memory structures, and agent patterns.

0 installs

Trust: 37 — Low

Science

Ask AI about io.github.4rgon4ut/sutra

I know everything about io.github.4rgon4ut/sutra. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Loading tools...

Reviews

Documentation

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)

uv tool install context-engineering-mcp

Using `pip`

pip install context-engineering-mcp

Configuration

Select your agent below and copy-paste the config.

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "sutra": {
      "command": "uv",
      "args": ["tool", "run", "context-engineering-mcp"]
    }
  }
}

Claude Code

Run this in your terminal:

claude mcp add sutra uv tool run context-engineering-mcp

Aider

Run aider with the mcp flag:

aider --mcp "uv tool run context-engineering-mcp"

Or add to .aider.conf.yml:

mcp: ["uv tool run context-engineering-mcp"]

Gemini CLI

Add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "sutra": {
      "command": "uv",
      "args": ["tool", "run", "context-engineering-mcp"]
    }
  }
}

Cursor / Windsurf

In MCP settings, add a new server:

Name: Sutra
Type: command
Command: uv tool run context-engineering-mcp

Codex

Add to your config (TOML):

[mcp_servers.sutra]
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).

Clone the repo:

git clone https://github.com/4rgon4ut/sutra.git
cd sutra

Install dependencies:

uv sync --all-extras
# OR
pip install -e ".[dev]"

Run tests:
```
pytest
```

License

MIT