agentcast-mcp

Un servidor MCP que ofrece a los asistentes de IA la capacidad de imponer una salida estructurada: extraer JSON de texto desordenado de un LLM, validarlo contra una especificación de forma y producir el mensaje de retroalimentación de reintento cuando el modelo devuelve una forma incorrecta.

Construido sobre @mukundakatta/agentcast. Funciona con Claude Desktop, Cursor, Cline, Windsurf, Zed y cualquier otro cliente MCP.

Herramientas expuestas

extract_json

Extrae un valor JSON de una salida desordenada de un LLM. Prueba con todo el texto, luego con un bloque ```json ``` delimitado y, finalmente, con la subcadena {...} / [...] equilibrada más grande. Devuelve el valor analizado y la estrategia que tuvo éxito.

{
  "text": "Sure, here you go:\n```json\n{\"answer\": 42}\n```\nLet me know!"
}

→

{
  "value": { "answer": 42 },
  "found": true,
  "source": "fenced_json"
}

source es uno de los siguientes: whole, fenced_json, fenced_plain, balanced_substring o none.

validate_response

Valida un valor JSON analizado contra una especificación de forma de agentcast. La especificación asigna el nombre del campo al tipo: string, number, boolean, array, object. Añade ? al final para indicar que es opcional.

{
  "value": { "name": "ada" },
  "shape": { "name": "string", "age": "number" }
}

→

{
  "valid": false,
  "error": "missing required field 'age'"
}

build_retry_prompt

Dada un historial de intentos, produce el mensaje de retroalimentación de error de validación que agentcast añade a la conversación cuando el modelo devuelve una forma incorrecta. Codifica el patrón de "error de validación como retroalimentación" para clientes MCP que no son de Node y que desean ejecutar el mismo bucle de reintento manualmente.

{
  "attempts": [
    { "text": "{\"name\":\"ada\"}", "error": "missing required field 'age'" }
  ],
  "expected_shape": { "name": "string", "age": "number" }
}

→

{
  "feedback": "Your previous response did not match the required shape. Error: missing required field 'age'\n\nTry again. Respond with ONLY valid JSON that fixes the error above.\n\nExpected shape: {\"name\":\"string\",\"age\":\"number\"}"
}

Related MCP server: JSONShelf

Instalación

Claude Desktop

Añadir a claude_desktop_config.json:

{
  "mcpServers": {
    "agentcast": {
      "command": "npx",
      "args": ["-y", "@mukundakatta/agentcast-mcp"]
    }
  }
}

Cursor / Cline / Windsurf / Zed

La misma estructura, en el archivo mcp.json apropiado para su cliente. La mayoría de los clientes lo detectan automáticamente mediante npx -y @mukundakatta/agentcast-mcp.

Instalación local

npm install -g @mukundakatta/agentcast-mcp
mcp-agentcast        # listens on stdio

Por qué es importante

Cuando se supone que un LLM debe devolver datos estructurados, a veces envuelve el JSON en prosa, delimitadores o campos alucinados. El JSON.parse estándar lanza un error. Las expresiones regulares creadas manualmente no detectan estructuras anidadas. Este servidor MCP proporciona a cualquier modelo que controle un agente una forma real de (1) extraer JSON de la respuesta, (2) comprobar que coincide con la forma esperada y (3) construir el aviso de reintento exacto que empuja al modelo a corregirlo en el siguiente turno.

Licencia

MIT.