MCP
python3 -m venv .venv or python -m venv .venv source .venv/bin/activate pip install --upgrade pip pip install -r requirements.txt .venv\Scripts\python.exe app.py
Local MCP + Groq + OpenAI Agents SDK
Este ejemplo de aula contiene:
app.py: un servidor MCP Streamable HTTP local y persistente con varias herramientas.mcp_groq_agent.ipynb: un agente que descubre e invoca esas herramientas.
Configuración
Usa Python 3.10 o superior. En una terminal, entra en esta carpeta del proyecto, crea un entorno virtual e instala todo lo necesario tanto para el servidor como para el notebook (sustituye python3.11 por tu comando moderno de Python si es necesario):
cd /Users/somenathmandal/Documents/transfer/grok-playground/MCP
python3.11 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txtCrea .env a partir del ejemplo y pon tu clave API de Groq en él:
cp .env.example .envGROQ_API_KEY=replace_with_your_groq_key
GROQ_MODEL=openai/gpt-oss-20bNunca hagas commit ni compartas .env; está excluido por .gitignore.
Related MCP server: nit-mcp-server
Ejecutar el servidor MCP
Inicia el servidor MCP en una terminal y déjalo corriendo:
source .venv/bin/activate
.venv/bin/python app.pyEl endpoint de Streamable HTTP ya está disponible en:
http://127.0.0.1:8000/mcpMantén esa terminal abierta. Pulsa Ctrl+C cuando quieras detener el servidor.
Ejecutar el notebook del agente
En una segunda terminal:
cd /Users/somenathmandal/Documents/transfer/grok-playground/MCP
source .venv/bin/activate
jupyter lab mcp_groq_agent.ipynbSelecciona el kernel de Python .venv si Jupyter lo solicita y ejecuta las celdas de arriba a abajo. El notebook se conecta directamente a http://127.0.0.1:8000/mcp; no inicia ni importa app.py. La clave API de Groq se carga desde .env y nunca se guarda en el notebook.
Cómo encajan las piezas
Notebook agent
-> Groq OpenAI-compatible API (model reasoning and tool selection)
-> http://127.0.0.1:8000/mcp (tool discovery and execution)
-> app.py MCP toolsEl servidor debe estar ejecutándose antes de ejecutar las celdas de conexión MCP. Si el notebook informa de un error de conexión, confirma primero que la terminal del servidor indica que Uvicorn está corriendo en http://127.0.0.1:8000.
El notebook también protege contra variables de entorno obsoletas de archivos de certificado que a veces se heredan de los lanzadores de notebooks. Solo elimina una variable de certificado cuando la ruta referenciada no existe; los ajustes de certificado personalizados válidos se conservan.
MCP
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Exposes FEDLIN's public security scanners as agent-callable tools over Streamable HTTP.
16 AI-native tools with dual SSE + streamable-http transport. Free tier available.
AI Reasoning Cache & Consensus Layer with 11 MCP tools via Streamable HTTP.
Remote MCP server exposing SMI Aware tools, resources, and skills over Streamable HTTP.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceFlask-based server that exposes callable tools via HTTP endpoints for AI agents like Gemini CLI, enabling agent orchestration, tool introspection, and workflow automation with a centralized tool registry.-
- FlicenseNot gradedqualityDmaintenanceExposes nit's code review agent as tools for Claude, enabling local path and GitHub PR/commit/URL review over Streamable HTTP.-
- FlicenseNot gradedqualityDmaintenanceEnables agents to discover and execute local tools via a Streamable HTTP endpoint using the Groq OpenAI-compatible API.-
- FlicenseNot gradedqualityDmaintenanceEnables an agent to discover and call local MCP tools over a Streamable HTTP endpoint using Groq for reasoning and tool selection.-