MCP server de Context Engineering
Commit 19 sept 2026Proporciona un centro de capacitación y un marco de implementación para construir sistemas de IA con memoria semántica lista para producción y RAG híbrido utilizando MCP.
También conocido como timothywarner-org/context-engineering
- Stars
- 28
- Herramientas
- 2
- Descargas, 30 días
- —
- Última versión
- —
- Último commit
- 19 sept 2026
- Licencia
- MIT
¿Qué es Context Engineering MCP?
Proporciona un centro de capacitación y un marco de implementación para construir sistemas de IA con memoria semántica lista para producción y RAG híbrido utilizando MCP. Expone 2 herramientas, como warn_search_tools, warn_describe_tool.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Context Engineering
El objetivo principal de este centro de capacitación es la construcción de sistemas de IA con memoria a largo plazo y generación aumentada por recuperación (RAG) híbrida. Proporciona un marco para que los desarrolladores implementen memoria semántica lista para producción utilizando el Model Context Protocol. El repositorio incluye una aplicación insignia llamada WARNERCO Schematica, que demuestra un pipeline de LangGraph de nueve nodos que gestiona cuatro niveles de memoria distintos: working scratchpad, eventos episódicos, almacenes vectoriales semánticos y prompts procedimentales.
Los usuarios pueden interactuar con estos sistemas mediante configuraciones locales usando Claude Desktop, Claude Code o VS Code Copilot. El framework admite varios modelos de despliegue, que van desde servidores stdio locales hasta MCP servers remotos asegurados por Entra ID OAuth y Azure API Management. Los desarrolladores pueden explorar diferentes niveles de implementación a través de laboratorios específicos, que incluyen proyectos iniciales basados en JavaScript, interfaces de chat basadas en Python y superficies de UI interactivas que utilizan la extensión SEP-1865. El sistema está diseñado para ser probado con el MCP Inspector y gestionado con el gestor de paquetes uv.
Qué puedes hacer con él
- 1Implementar sistemas de memoria multinivelUn desarrollador puede usar el pipeline de LangGraph para orquestar niveles de memoria working, episodic, semantic y procedural para un asistente de IA.
- 2Desplegar MCP servers remotos segurosPuedes configurar un MCP server remoto que utilice Azure Functions y esté protegido por Entra ID OAuth.
- 3Crear interfaces de usuario de IA interactivasLos desarrolladores pueden construir MCP servers que rendericen superficies interactivas directamente dentro de Claude Desktop.
- 4Optimizar el descubrimiento de herramientas para clientesUn cliente de IA puede usar herramientas de meta-discovery para buscar esquemas de herramientas específicos sin cargar todo el registro a la vez.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Herramientas de Context Engineering MCP 2
Detectado desde el READMEwarn_search_toolswarn_describe_tool
| warn_search_tools | — | |
| warn_describe_tool | — |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesibletimothywarner-org/context-engineering is public and reachablegithub.com/timothywarner-org/context-engineering ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-09-19github.com/timothywarner-org/context-engineering ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo2 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo tool named like delete, drop or execAprobado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHubContext Engineering with MCP: Build AI Systems That Actually Remember
Welcome to the training hub for mastering Context Engineering with Model Context Protocol (MCP). This course teaches you to implement production-ready semantic memory systems for AI assistants using Python, FastAPI, FastMCP, and LangGraph.
Quick Start
Prerequisites
- Python 3.13 (pinned in
.python-version) —onnxruntime(a chromadb dependency) does not yet ship 3.14 wheels - Node.js 20+ (for Lab 01 and MCP Inspector)
- uv package manager (recommended for Python)
- Claude Desktop or Claude Code
Option 1: Hello MCP Lab (Beginner Entry Point)
git clone https://github.com/timothywarner-org/context-engineering.git
cd context-engineering/labs/lab-01-hello-mcp/starter
npm install && npm start
# Test with MCP Inspector (in another terminal)
npx @modelcontextprotocol/inspector node src/index.js
Option 1.5: MCP Chat CLI Lab (Python Bridge)
cd labs/lab-02-mcp-chat
.\run.ps1
run.ps1 is the on-rails launcher: it bootstraps .env, lifts ANTHROPIC_API_KEY from the repo-root .env, and launches the chat REPL. Lab 02 is the smallest complete Python MCP client + stdio server + REPL in the repo - the conceptual bridge between Lab 01 (JS hello-world) and WARNERCO (production-shaped).
Option 1.7: MCP Apps Lab (Interactive UI Surfaces)
cd labs/lab-03-mcp-apps
Lab 03 ships three npm MCP servers (budget-allocator, map, system-monitor) that render interactive ui:// surfaces in Claude Desktop via SEP-1865 (MCP Apps extension, spec 2026-01-26). See labs/lab-03-mcp-apps/README.md.
Option 1.9: Remote MCP + OAuth on Azure
Lab 04 is a remote MCP server secured by Entra ID OAuth, fronted by Azure API Management as the authorization-server facade, with an Azure Functions Python backend. Deploy with azd up, connect per remote-mcp-apim-functions-python/QUICKSTART.md, then tear down the same day with azd down --purge --force.
Option 2: WARNERCO Schematica (Flagship Teaching App)
cd src/warnerco/backend
uv sync
uv run uvicorn app.main:app --reload # HTTP server at http://localhost:8000
uv run warnerco-mcp # MCP stdio server for Claude Desktop
uv run warnerco-restart # Force-kill port 8000 and restart uvicorn
The warnerco-restart command (from scripts/restart_server.py) terminates anything bound to port 8000 (Windows: netstat + taskkill /F /T; POSIX: lsof + SIGKILL) before restarting. Flags: --kill-only, --port N.
Course Structure (4 x 50 Minutes)
| Segment | Topic | Focus |
|---|---|---|
| 1 | Context, Made Visible | Consumer LLMs hide context; dev tools (Claude Code, Copilot) expose it |
| 2 | MCP: Standard for Context | The protocol + a server on the official mcp SDK; current best practices |
| 3 | Memory Tiers in a Real App | WARNERCO's four CoALA tiers live; orchestration kept under the hood |
| 4 | MCP in the Tools You Use | Claude Code + GitHub Copilot in VS Code as context-engineering surfaces |
Full plan: instructor/course-plan-june-2026.md (context-first, official-SDK-first; delivered 2026-06-30). The earlier orchestration-forward plan is archived under instructor/archive/.
Segment Notebooks
notebooks/segment-1.ipynb through segment-4.ipynb are four prepopulated, verified teaching notebooks, one per 50-minute segment. Each opens with a repo-root anchor cell that walks up to .git, so it runs from any working directory. They print live counts (never hardcoded), and Segment 3 runs the full pipeline with live Anthropic prose. Open them in VS Code with the Jupyter extension and Run All. Verified to run error-free from both the repo root and notebooks/.
WARNERCO Schematica Architecture
The flagship teaching application exercises all four CoALA memory tiers (Sumers et al. 2024) in a 9-node LangGraph pipeline:
+--------------------------------------------------------------------------+
| FastAPI + FastMCP |
+--------------------------------------------------------------------------+
| LangGraph Flow (9-node CoALA-tiered RAG) |
| parse_intent -> query_graph -> inject_scratchpad -> recall_episodes -> |
| retrieve -> compress_context -> reason -> respond -> log_episode |
+--------------------------------------------------------------------------+
| Four CoALA Memory Tiers |
| +------------+ +-----------+ +----------+ +------------------------+ |
| | Working | | Episodic | | Semantic | | Procedural | |
| | Scratchpad | | events.db | | Vector | | MCP Prompts (versioned)| |
| | (SQLite) | | (SQLite) | | store | | catalog://procedural | |
| +------------+ +-----------+ +----------+ +------------------------+ |
+--------------------------------------------------------------------------+
| Consolidation ("sleep cycle"): scratchpad+episodic --(ctx.sample)--> semantic |
+--------------------------------------------------------------------------+
CoALA Tier Reference
| Tier | What it stores | Backed by | LangGraph node |
|---|---|---|---|
| Working | Session observations & inferences | data/scratchpad/notes.db (SQLite) |
inject_scratchpad |
| Episodic | Timestamped events with importance | data/episodic/events.db (SQLite) |
recall_episodes + log_episode |
| Semantic | Durable facts (incl. consolidated FACT-*) |
Vector store (Chroma / Azure / JSON) | retrieve |
| Procedural | Versioned skills/workflows | MCP @mcp.prompt() registrations |
(user-invoked, not in pipeline) |
The reason node (LangGraph node 6) synthesizes prose via the official anthropic Python SDK (AsyncAnthropic); if the backend .env lacks the key it degrades gracefully - retrieval still works and the prose shows a fallback message.
Episodic recall uses Park et al.'s scoring formula — α_recency · 0.5^(hours/half_life) + α_importance · stored + α_relevance · cosine(query, summary) — and warn_episodic_recall returns the per-event score breakdown so students can see why each memory surfaced.
The knowledge graph is indexed at src/warnerco/backend/data/graph/knowledge.db with 117 entities and 221 relationships across 6 predicates (has_tag, compatible_with, belongs_to_model, has_status, has_category, contains).
Progressive Tool Loading
The server registers 28 MCP tools, 12 resources, and 5 prompts. Two meta-discovery tools implement progressive tool loading per Anthropic's "code execution with MCP" guidance:
warn_search_tools(query, detail, limit)— keyword discovery with detail levelsname,summary,fullwarn_describe_tool(name)— full schema for a single tool by name
Both meta-tools self-exclude from warn_search_tools results, so count is up to 26 even when total is 28. Clients can list tools cheaply, then pull full schemas only for what they actually plan to call.
Repository Structure
context-engineering/
├── src/warnerco/backend/ # WARNERCO Schematica (FastAPI + FastMCP + LangGraph)
├── labs/lab-01-hello-mcp/ # Lab 01: Hello MCP, single add tool (JS)
├── labs/lab-02-mcp-chat/ # Lab 02: MCP client + server + chat REPL (Python, vendored)
├── labs/lab-03-mcp-apps/ # Lab 03: MCP Apps, interactive ui:// surfaces (JS/TS, SEP-1865)
├── remote-mcp-apim-functions-python/ # Lab 04: remote MCP + Entra ID OAuth via APIM (Python + bicep)
├── notebooks/ # Four verified segment teaching notebooks (segment-1..4)
├── docs/ # Student materials, tutorials, diagrams
├── instructor/ # Instructor-only materials
├── config/ # Sample MCP client configurations
├── .vscode/ # VS Code workspace configuration
├── .claude/ # Claude Code agents and skills
└── CLAUDE.md # Development instructions (SOURCE OF TRUTH)
For development details, see CLAUDE.md - the source of truth for:
- Complete MCP tool reference (28 tools)
- API endpoint documentation
- Environment variable configuration (incl.
EPISODIC_*) - 9-node LangGraph pipeline details
- All four CoALA memory tiers (Working / Episodic / Semantic / Procedural)
For the framework explainer (read this first): see docs/tutorials/coala-explainer.md — what CoALA is and where each tier lives in the WARNERCO codebase.
For the classroom demo: see docs/tutorials/coala-memory-walkthrough.md — the ~4-minute four-tier classroom path.
MCP Client Configuration
Claude Desktop
Windows: %APPDATA%\Claude\claude_desktop_config.json
Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"warnerco": {
"command": "uv",
"args": ["run", "warnerco-mcp"],
"cwd": "C:/github/context-engineering/src/warnerco/backend"
}
}
}
Claude Code (project scope)
.claude/mcp.json is checked in with two entries pointing at the same server: claude-warnerco-schematica and claude-warnerco-coala-memory (the second pre-pins the episodic-memory env vars for class demos).
VS Code Copilot
.vscode/mcp.json is checked in with a single vscode-warnerco-schematica entry (MEMORY_BACKEND=chroma) plus the GitHub Copilot remote MCP server ghcopilot-warner. To list servers in VS Code: Cmd/Ctrl+Shift+P → MCP: List Servers.
Testing with MCP Inspector
npx @modelcontextprotocol/inspector uv run warnerco-mcp
# Opens http://localhost:6274
Resources
- MCP Specification - Official protocol documentation
- FastMCP Documentation - Python MCP framework
- CLAUDE.md - Development instructions for this repository
Your Instructor
Tim Warner
Microsoft MVP - Azure AI and Cloud/Datacenter Management Microsoft Certified Trainer (25+ years)
- Website: techtrainertim.com
- GitHub: @timothywarner
- LinkedIn: linkedin.com/in/timothywarner
License
MIT License - 2026 Timothy Warner
Now go build AI systems that actually remember!
Preguntas sobre Context Engineering MCP
¿Qué herramientas proporciona Context Engineering MCP?
Expone 2 herramientas, incluidas warn_search_tools, warn_describe_tool.
¿Qué tecnologías se utilizan para construir los sistemas de memoria?
El sistema utiliza Python, FastAPI, FastMCP y LangGraph para implementar memoria semántica y RAG híbrido.
¿Cuáles son los diferentes niveles de memoria en la aplicación WARNERCO?
La arquitectura incluye cuatro niveles de memoria CoALA: Working (SQLite), Episodic (SQLite), Semantic (Vector store) y Procedural (MCP Prompts).
¿Puedo probar el MCP server usando un inspector?
Sí, puedes usar el MCP Inspector para probar el servidor ejecutando el comando npx que se proporciona en la documentación.
¿El servidor admite conexiones remotas con autenticación?
Sí, el Lab 04 muestra un MCP server remoto asegurado mediante Entra ID OAuth a través de Azure API Management.