grok-bot
0fbbaf71d5
Print/KDP 6×9 Grayscale (just, QA, Assets), erweiterter Agent-Harness und Manuskript-/Abbildungs-Stand mit frischen eBook- und Print-PDFs.
12 KiB
Anhang D: Weiterführende Ressourcen & offizielle MCP-Dokumentation
Kuratierte Einstiege (Stand der Empfehlungslogik 2026). Links und Produktnamen können sich ändern – spezifikationsnahe Quellen priorisieren.
Haltbarkeit von Inhalten in diesem Buch
Lese volatile Abschnitte als Belege für stabile Muster, nicht als kanonische API-Doku.
Normative MCP-Referenz (Buch-Pin): MCP Specification 2025-11-25 Site/Docs: modelcontextprotocol.io
| Schicht | Inhalt (Auszug) | Haltbarkeit | Buch-Fokus |
|---|---|---|---|
| Stabil | Host–Client–Server; Tools, Resources, Prompts; Trust Boundaries; Context-Engineering-Prinzipien; Harness-Design; Role Policies | Jahre (konzeptnah); Primitiven auch über Spec-Sprünge hinweg relativ stabil | Primär |
| Mittelstabil | On-demand Loading, Progressive Disclosure, Verify-Loop, Hybrid-KB, Multi-Agent-Rollen, Eval-Scorecards, Server-Schnitt | 1–3 Jahre (Details evolvieren) | Primär |
| Volatil / Übergangsphase | MCP-Protokollkern Session/Handshake/Request-Envelope (2025-11-25 → 2026-07-28, Kap. 4.8); SDK-APIs (FastMCP, offizielle SDKs); Framework-Bindings; Host-Config-Syntax; Paketversionen | Monate bis ~2 Jahre (Kern-Übergang); SDK oft < 1 Jahr | Illustration + Entscheidung (4.8) |
Begründung Primitiven vs. Protokollkern: Die Revision 2026-07-28 bricht primär den Zustands- und Handshake-Vertrag, nicht die Capability-Klassen. Tools/Resources/Prompts bleiben die stabile Integrationssprache; der Protokollkern ist in der Übergangsphase 2026/2027 bewusst als volatil markiert.
| Schicht | Aktualisierung |
|---|---|
| Stabil | nur bei Spec-Bruch / konzeptionellem Wandel (Errata oder neue Auflage) |
| Mittelstabil | bei etablierten Praxiswechseln |
| Volatil / Übergangsphase | Kap. 4.8 bei Protokollkern; Companion fortlaufend (latest); Buch-Tag book-YYYY-MM |
Companion: Verzeichnis code/ in diesem Repository (Tags book-2026-07 / latest) · Matrix: code/COMPATIBILITY.md
D.1 Model Context Protocol (primär)
Buch-Pin (normativ in diesem Manuskript): Spec-Version 2025-11-25. Technische Aussagen zu Lifecycle, Primitives und Transport verweisen auf diese Version; neuere Spec-Releases können Details ändern – Companion und Errata tracken das.
Revision 2026-07-28 (stateless): größte Protokollrevision seit Start (Sessions/Handshake entfallen, self-contained Requests, MRTR/InputRequiredResult, Auth-Hardening, formale Deprecation-Policy). Normativ im Buch nicht die Basis – Behandlung in Kapitel 4.8. Offizielle Spec: specification/2026-07-28 (Site-Default kann neuer sein; Buch-Pin bleibt 2025-11-25). Companion bleibt auf 2025-11-25 (siehe code/COMPATIBILITY.md).
| Ressource | URL / Ort | Nutzen |
|---|---|---|
| Offizielle MCP-Site / Docs | https://modelcontextprotocol.io | Architektur, Tutorials, Concepts |
| Spezifikation 2025-11-25 | specification/2025-11-25 | normative Referenz (Buch-Pin) |
| Lifecycle (2025-11-25) | …/basic/lifecycle | initialize, capabilities, initialized |
| Tools | …/server/tools | model-controlled actions |
| Resources | …/server/resources | application-controlled context |
| Prompts | …/server/prompts | user-controlled templates |
| Transports | Spec → Transports (STDIO, Streamable HTTP) | Data Layer vs. Transport |
| Architecture Overview | Docs → Learn / Architecture | Host, Client, Server, Layers |
| Spec 2026-07-28 (released; nicht Buch-Pin) | specification/2026-07-28 | Stateless-Kern; Entscheidungshilfe Kap. 4.8 |
| Python SDK | GitHub modelcontextprotocol/python-sdk |
Server/Client Referenz |
| TypeScript SDK | GitHub modelcontextprotocol/* TS SDK |
IDE-/Node-Hosts |
| FastMCP | PrefectHQ FastMCP / SDK-Bundle je Version | ergonomische Server-DX (volatil) |
| Companion (dieses Buch) | code/ + code/COMPATIBILITY.md |
gepinnte Demo, CI, Host-Matrix (2025-11-25) |
| Community/Registry-Verzeichnisse | je Ökosystem (mcp-registry u. Ä.) | Server-Entdeckung – mit Vorsicht |
Lese-Reihenfolge: Architecture → Spec Basics (Lifecycle 2025-11-25, Tools/Resources/Prompts, Transports) → Kap. 4.8 (Übergang 2026-07-28) → SDK Quickstart → Security Notes → Companion-Demo.
Bei Spec-Bruch: Errata / neue Buch-Auflage für stabile Aussagen; Companion trackt SDK-Anpassungen unter latest (Pin bleibt bis neuer Buch-Tag).
D.2 Agenten-Frameworks & Orchestrierung (Auswahl)
| Thema | Beispiele zum Vertiefen |
|---|---|
| Graph/State | LangGraph-Dokumentation und Tutorials |
| Crew/Rollen | CrewAI Docs |
| Multi-Agent Research | AutoGen-Familie und Nachfolger |
| Enterprise / Microsoft-nah | Semantic Kernel Agent Patterns |
| MCP-first Runtimes | mcp-agent und ähnliche schlanke Hosts |
Vergleichsachsen: Kap. 6.
D.3 Context Engineering, RAG, Memory
| Thema | Richtung |
|---|---|
| RAG Patterns | Chunking, Hybrid Search, Rerank, GraphRAG-Übersichten |
| Code Knowledge Graphs vs. Vector-RAG | Öffentliche Arbeiten 2025/26 (z. B. RepoGraph/SWE-bench; AST-Graph-Eval. arXiv:2601.08773): Vorteile v. a. bei Multi-Hop-/Architekturfragen – Größenordnung query-abhängig, keine universellen 10×-Faktoren |
| Memory-Architekturen | episodic/semantic/procedural (Kap. 3, 5) |
| Lost-in-the-Middle / Long Context | Liu et al. 2023+; Research-Zusammenfassungen und Vendor-Reports kritisch lesen; Anhang F.1 |
| Prompt vs Context Engineering | interne Style Guides + dieses Buch Kap. 3.7 |
D.4 Security
| Thema | Richtung |
|---|---|
| Prompt Injection | OWASP LLM Top Risks, Vendor Security Guides |
| MCP Security | Community- und Industry-Papers 2025/26; Kap. 11 |
| Supply Chain | Lockfiles, SBOM, signed artifacts, interne Mirrors |
| OAuth/OIDC | Provider-Docs; short-lived tokens, least scope |
D.5 Coding Agents & IDEs
| Host-Klasse | Beispiele (Ökosystem) | Fokus |
|---|---|---|
| Agentic IDEs | Cursor, Windsurf, … | UX + MCP Config |
| CLI Agents | Claude Code, … | Terminal-native Loops |
| Open Stacks | Continue.dev, … | Anpassbarkeit |
| Desktop | Claude Desktop, … | MCP-Pionier-Hosts |
Jeweils aktuelle Docs zu MCP server configuration, Secrets und Tool Approval lesen (Kap. 9).
D.6 Evaluierung
| Ressource-Typ | Nutzen |
|---|---|
| Interne Eval-Suite | entscheidend (Anhang C) |
| SWE-Bench-ähnliche Public Sets | Orientierung, nicht eure Wahrheit |
| MCP-Bench (Wang et al., arXiv:2508.20453) | multi-step Tool-Use über MCP-Server |
| MCP-AgentBench (Guo et al., AAAI 2026) | MCP-mediated Tasks, outcome-Eval |
| MCPSecBench (Yang et al., arXiv:2508.13220) | Security-Angriffsflächen MCP |
| Repo-/Code-Graph-Papers | Orientierung zu struktureller Retrieval-Qualität; immer gegen eure Task-Klasse validieren |
| Tracing-Tools | LangSmith, OpenTelemetry-Stacks, vendor traces |
| Red-Team Prompt Sets | Safety-Gates |
| Empirischer Überblick | Anhang F (Feldstudien, Evidenz-Matrix, TCO) |
D.6a Produktivität, DORA & Codequalität (Kernquellen)
| Quelle | Jahr | Typ | Nutzen im Buch |
|---|---|---|---|
| Peng et al. / MS Research – Impact of AI on Developer Productivity (GitHub Copilot) | 2023 | Lab-RCT | ≈55,8 % Lab-Speed; Kap. 13, Anhang F |
| Cui et al. – Effects of Generative AI on High-Skilled Work (3 Firmen-RCTs, n≈4867) | 2025 | Feld-RCT | ≈+26 % Tasks/PRs (SE 10,3 %); Junior-Effekt |
| Ziegler et al. – Measuring GitHub Copilot’s Impact on Productivity (CACM) | 2024 | Telemetrie+Survey | Acceptance Rate vs. wahrgenommene Produktivität |
| METR / Becker et al. – Early-2025 AI on Experienced OSS Devs (arXiv:2507.09089) | 2025 | RCT | +19 % Zeit mit AI auf reifen eigenen Repos |
| DORA – State of AI-assisted Software Development | 2025 | Branchenreport | AI als Amplifier; dora.dev / Google Cloud |
| DORA / State of DevOps (GenAI-Befunde) | 2024–25 | Branchenreport | Throughput vs. Stabilität, J-Curve |
| GitClear – AI Code Quality / Maintainability Gap | 2024–2026 | Observational large-n | Churn, Copy/Paste, Refactor-Trends |
| Liu et al. – Lost in the Middle | 2023+ | Studie | Positionseffekte langer Kontexte; Kap. 3 |
Links und Preprints ändern sich – speichert DOIs/arXiv-IDs im Team-Wiki und prüft 90-täglich (D.9).
D.6b MCP Security (Incidents & Research)
| Ressource | Jahr | Nutzen |
|---|---|---|
| Simon Willison – MCP prompt injection / tool descriptions | 2025 | Design-Risiko Tool-Meta |
| Invariant Labs – Tool Poisoning (cross-server) | 2025 | Multi-Server Trust |
| GitHub MCP cross-repo data heist (disclosed) | 2025 | Untrusted Issue-Content |
| Snyk – CVEs in Community-MCP-Servern (u. a. aws-mcp, markdownify) | 2025 | Supply Chain |
| Anthropic mcp-server-git CVE-2025-68143 / 68144 / 68145 | 2025/26 | Reference-Server-Härte |
| MCP Inspector CVE-2025-49596 | 2025 | Dev-Toolchain RCE |
| Unit42 – MCP Sampling attack vectors | 2025 | Sampling-Surface |
| MCPSecBench (arXiv:2508.13220) | 2025/26 | Systematische Security-Eval |
| OWASP LLM Top Risks | laufend | Framework Prompt Injection & Co. |
Details und Einordnung: Anhang F.6, Controls: Kap. 11.
D.7 Standards & Nachbartechnologien
| Standard / Idee | Verhältnis zu MCP |
|---|---|
| OpenAPI | Downstream-APIs hinter MCP-Servern |
| JSON Schema | Tool-Argumente |
| OIDC/OAuth | Remote Auth |
| OpenTelemetry | Tracing von Tool-Calls |
| A2A / Agent-Kommunikationsansätze | ergänzend; Shared Context oft robuster (Kap. 5) |
D.8 Bücher, Kurse, Communities (Hinweis)
- LLM-System-Design- und AI-Engineering-Bücher (verschiedene Autoren) – kritisch auf Hype prüfen
- Offizielle Vendor-Kurse zu jeweiligen Hosts
- Engineering-Blogs großer Plattformteams zu Agent-Reliability
- Interne Gilden: beste Ressource ist oft euer Server-Katalog + Postmortems
D.9 Wie du Ressourcen im Team pflegst
- Eine Living Doc „AI Engineering Sources“ mit Owner
- Alle 90 Tage Links auf Broken/Outdated prüfen
- Spec-Version, die ihr supported, explizit nennen
- Shadow-PDFs und unbelegte „10x“-Claims nicht als Policy-Grundlage
D.10 Buchinterne Landkarte
| Interesse | Kapitel |
|---|---|
| MCP Basics | 2.6, 4.7 |
| Context Engineering | 3.7, 7.8, 10.8 |
| Harness / Skills | 4.5, 5.4, 5.11, 10.12, 11.10 |
| Projekt-Information / AGENTS.md | 5.12, 10.13 |
| Multi-Agent | 5.10, 8 |
| Frameworks | 6 |
| IDE/Remote | 9 |
| Hands-on | 10 + code/ |
| Security/Governance | 11 |
| Zukunft/Rollen | 12, 13 |
| Empirie / Feldstudien / Benchmarks | Anhang F, 6.5, 13.1, Anhang C |