Demo de HTTP Streamable para MCP TP5

Este proyecto recrea el objetivo de la demo:

• Servidor MCP que expone dos herramientas.

• Prueba con @modelcontextprotocol/inspector.

• Agente compatible con LangChain/LangGraph que utiliza MCP a través de HTTP Streamable.

• Configuración de agente de IA en n8n utilizando MCP a través de HTTP Streamable.

Nota importante de seguridad

La clave de OpenAI pegada en el prompt fue expuesta en el chat. Revóquela y cree una nueva clave antes de ejecutar el agente. Coloque la nueva clave en .env; no la suba al repositorio.

Related MCP server: SampleMCP

Configuración

Copy-Item .env.example .env
npm install

Edite .env y establezca:

OPENAI_API_KEY=your_new_key

Iniciar el servidor MCP

npm run server

El endpoint de MCP es:

http://127.0.0.1:3000/mcp

El endpoint de estado (health) es:

http://127.0.0.1:3000/health

Prueba con el Inspector MCP

En una terminal, mantenga el servidor en ejecución:

npm run server

En otra terminal, enumere las herramientas con la CLI del Inspector:

npm run inspector:list-tools

En Windows, la CLI actual del Inspector puede imprimir la respuesta JSON correcta y luego cerrarse con una aserción de Node/libuv. Si ve el JSON de tools que contiene calculate y text_stats, la llamada MCP en sí tuvo éxito.

Llame a una herramienta con la CLI del Inspector:

npx --yes @modelcontextprotocol/inspector --cli http://127.0.0.1:3000/mcp --transport http --method tools/call --tool-name calculate --tool-arg operation=add --tool-arg "numbers=[2,3,4]"

También puede abrir la interfaz de usuario del Inspector:

npm run inspector

Luego seleccione:

Transport: Streamable HTTP
URL: http://127.0.0.1:3000/mcp

Prueba de humo local

npm run smoke

Esto enumera las herramientas MCP y llama a calculate.

Agente de LangChain

Asegúrese de que el servidor esté en ejecución y que .env contenga una OPENAI_API_KEY válida y rotada.

npm run agent

Prompt personalizado:

npm run agent -- "Calcule 42 / 6 puis analyse le texte: Bonjour depuis MCP."

Agente de n8n

Siga docs/n8n-agent.md.

La configuración de la herramienta de cliente MCP de n8n es:

Endpoint: http://127.0.0.1:3000/mcp
Server Transport: HTTP Streamable
Authentication: None
Tools to Include: All