Skip to main content

MCP server for Context Engineering templates and protocols

Project description

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).

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

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

context_engineering_mcp-0.1.1.tar.gz (77.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

context_engineering_mcp-0.1.1-py3-none-any.whl (23.1 kB view details)

Uploaded Python 3

File details

Details for the file context_engineering_mcp-0.1.1.tar.gz.

File metadata

File hashes

Hashes for context_engineering_mcp-0.1.1.tar.gz
Algorithm Hash digest
SHA256 b9b5b1f001f0c6c0fb83e6001eb853fa25364544a06d5f03d4dce7919ed052e5
MD5 e71d91029033dd1a3baa80f815022396
BLAKE2b-256 c09f01cdc3b54046406210baf4925c32d44f1f7d8f300b95a0697915ae42b1bd

See more details on using hashes here.

File details

Details for the file context_engineering_mcp-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for context_engineering_mcp-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 16fe636be7aa3935c65b14b6c1f45077076e3fe899f0fde97a983a7e83d2aecc
MD5 9c72011cff6e5745234738029aeff1e1
BLAKE2b-256 5493a7b09dc2fda68333ffa24b63ebe0d6329646f009067f992d66e5fbddadc2

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page