agentcast-mcp
agentcast-mcp
Ein MCP-Server, der KI-Assistenten die Fähigkeit verleiht, strukturierte Ausgaben zu erzwingen: JSON aus unordentlichem LLM-Text zu extrahieren, es gegen eine Formspezifikation zu prüfen und eine Feedback-Nachricht für Wiederholungsversuche zu erstellen, wenn das Modell die falsche Form zurückgibt.
Aufgebaut auf @mukundakatta/agentcast. Funktioniert mit Claude Desktop, Cursor, Cline, Windsurf, Zed und jedem anderen MCP-Client.
Verfügbare Tools
extract_json
Extrahiert einen JSON-Wert aus unordentlicher LLM-Ausgabe. Versucht es mit dem gesamten Text, dann mit einem eingezäunten ```json ```-Block und schließlich mit dem größten balancierten {...} / [...]-Teilstring. Gibt den geparsten Wert sowie die erfolgreiche Strategie zurück.
{
"text": "Sure, here you go:\n```json\n{\"answer\": 42}\n```\nLet me know!"
}→
{
"value": { "answer": 42 },
"found": true,
"source": "fenced_json"
}source ist einer der Werte whole, fenced_json, fenced_plain, balanced_substring oder none.
validate_response
Validiert einen geparsten JSON-Wert anhand einer agentcast-Formspezifikation. Die Spezifikation ordnet Feldnamen Typen zu: string, number, boolean, array, object. Mit ? für optional ergänzen.
{
"value": { "name": "ada" },
"shape": { "name": "string", "age": "number" }
}→
{
"valid": false,
"error": "missing required field 'age'"
}build_retry_prompt
Erstellt basierend auf der bisherigen Historie die Validierungsfehler-Feedback-Nachricht, die agentcast an die Konversation anhängt, wenn das Modell die falsche Form zurückgegeben hat. Kodifiziert das Muster "Validierungsfehler als Feedback" für Nicht-Node-MCP-Clients, die dieselbe Wiederholungsschleife manuell steuern möchten.
{
"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: genpark-structured-extract-schema-validator-skill
Installation
Claude Desktop
Fügen Sie dies zu claude_desktop_config.json hinzu:
{
"mcpServers": {
"agentcast": {
"command": "npx",
"args": ["-y", "@mukundakatta/agentcast-mcp"]
}
}
}Cursor / Cline / Windsurf / Zed
Gleiche Struktur, in der entsprechenden mcp.json für Ihren Client. Die meisten Clients erkennen dies automatisch über npx -y @mukundakatta/agentcast-mcp.
Lokale Installation
npm install -g @mukundakatta/agentcast-mcp
mcp-agentcast # listens on stdioWarum das wichtig ist
Wenn ein LLM strukturierte Daten zurückgeben soll, verpackt es das JSON manchmal in Prosa, Begrenzungen oder halluzinierte Felder. Standard JSON.parse wirft Fehler. Selbst geschriebene Regex-Ausdrücke übersehen verschachtelte Strukturen. Dieser MCP-Server gibt jedem Modell, das einen Agenten steuert, eine echte Möglichkeit, (1) JSON aus der Antwort zu ziehen, (2) zu prüfen, ob es der erwarteten Form entspricht, und (3) die exakte Wiederholungsaufforderung zu erstellen, die das Modell dazu anregt, es im nächsten Schritt zu korrigieren.
Lizenz
MIT.
Available Tools
3 toolsbuild_retry_promptA
Given an attempt history, produce the retry feedback message agentcast would append to the conversation when the model returned the wrong shape. Codifies the "validation error as feedback" pattern for non-Node MCP clients.
Inputs: attempts (required), expected_shape.
extract_jsonA
Pull a JSON value out of messy LLM output. Tries the whole text, then a fenced json block, then the largest balanced {...}/[...] substring. Returns the parsed value plus which strategy succeeded.
Inputs: text (required).
validate_responseA
Validate a parsed JSON value against an agentcast shape spec. Spec maps field name to type: 'string', 'number', 'boolean', 'array', 'object'. Suffix with '?' for optional. Returns valid=true on success, or valid=false with a human-readable error string suitable for retry feedback.
Inputs: shape (required), value (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clear, distinct purpose: build_retry_prompt handles feedback generation, extract_json extracts JSON from text, and validate_response checks JSON against a spec. There is no functional overlap.
All tool names follow a consistent verb_noun pattern in snake_case (build_retry_prompt, extract_json, validate_response), making them predictable and easy to understand.
With only 3 tools, the server is slightly underpopulated but still appropriately scoped for the narrow domain of agent response validation and retry feedback. It covers the core workflow without unnecessary bloat.
The tools cover the essential pipeline of extracting JSON, validating it against a spec, and generating retry feedback. A minor gap is the lack of explicit handling of attempt history beyond what build_retry_prompt expects, but that is assumed provided by the client.
Maintenance
Related MCP Connectors
Deterministic JSON repair, validate, example-gen, schema-coerce for agents. Zero LLM, sub-10ms.
Repair broken JSON from LLM output and validate it against a JSON Schema.
Repair broken LLM JSON and check it against a JSON Schema. Flags cut-off output. Free trial.
Turn messy text into strict JSON schemas agents can trust (invoice, receipt, contact, resume).
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceDeterministic JSON validation and repair for AI agents. Validates, repairs, schema-checks, and diffs JSON so long-running agents don't corrupt their session state with malformed writes.MIT
- FlicenseNot gradedqualityNot gradedmaintenanceEnables deterministic extraction and validation of structured JSON data from inputs using a defined schema. It plugs into MCP-compatible clients like Claude Desktop, Cursor, and Windsurf to return standardized, schema-validated results.-
- AlicenseNot gradedqualityBmaintenanceProvides deterministic JSON repair and JSON Schema validation for malformed AI agent outputs, safely fixing unambiguous errors without an LLM and refusing ambiguous cases.49 PyPIMIT
- FlicenseNot gradedqualityNot gradedmaintenanceEnables agents and MCP clients to deterministically extract and repair JSON/schema issues such as truncated braces, markdown wrappers, and invalid types without LLM round-trips.-