mcp-server-template

Meinungsstarke Vorlage für den Bau schreibgeschützter MCP-Server, die Coding-Agenten tatsächlich gut nutzen können: I/O-Schnittstellen mit Timeouts, Offline-Tests, kompakte Textausgaben, Dokumentation mit minimalen Rechten.

Hier starten → BUILDING.md — der vollständige Workflow von der Idee bis zum veröffentlichten Server (etwa ein halber Tag).

Was enthalten ist: ein funktionierender Beispielserver (pypi_project HTTP-Tool mit fester Herkunft hinter einer gestubten Schnittstelle + word_stats reines Tool), Offline-Testsuite, CI-Workflow, CLAUDE.md-Konventionen und ein README-Gerüst unten.

Das Netzwerkbeispiel akzeptiert bewusst keine beliebigen URLs. „Schreibgeschützt“ macht einen URL-Abrufer nicht sicher: uneingeschränkte Ziele und verfolgte Weiterleitungen können Loopback-, private Netzwerk- oder Cloud-Metadaten-Dienste offenlegen. pypi_project erstellt nur https://pypi.org/...-Anfragen, lehnt URL-/Pfad-förmige Eingaben ab, folgt niemals Weiterleitungen, begrenzt die dekodierte Antwort auf 2 MiB und wendet eine 15-Sekunden-Frist für den gesamten Vorgang an.

README-Gerüst für deinen Server (ersetze diese gesamte Datei)

1. # mcp-<name> + einzeiliges Wertversprechen in Fettschrift

2. 4-zeiliges Nutzungstranskript (Du: … / Agent: → Tool-Aufrufe / Agent: Antwort)

3. Tools-Tabelle (Tool → was es zurückgibt)

4. Installation: claude mcp add <name> -e TOKEN=... -- python -m mcp_<name> + .mcp.json-Block

5. Token-Bereich / Sicherheit (minimale Rechte, Schreibgeschützt-Erklärung)

6. Design-Hinweise (warum schreibgeschützt, warum kompakter Text, warum Timeouts)

7. Lizenz + Kontaktzeile

Verwende die obige Struktur direkt; ersetze jeden Vorlagennamen und jedes Beispiel, bevor du einen abgeleiteten Server veröffentlichst.

Related MCP server: MCP Server Template

Sicherheit und Datenschutz

• Das Beispiel sendet nur den bereitgestellten Paketnamen an PyPI. Gib keine Geheimnisse oder privaten Kennungen in Tool-Argumente ein.

• PyPI-Projektzusammenfassungen sind vom Uploader kontrollierte Prosa, daher lässt das Beispiel sie bewusst aus der für Agenten sichtbaren Ausgabe weg. Behandle allen externen Text als unvertrauenswürdige Daten.

• Protokolliere niemals Anmeldedaten, Autorisierungs-Header, rohe private Antworten oder Benutzeraufforderungen.

• Dokumentiere, welcher externe Dienst jedes Argument erhält. Private CI-Logs und interne URLs sind sensibel, selbst wenn ein Tool sie nur liest.

• Halte beliebige URL-Abrufe aus abgeleiteten Servern fern, es sei denn, du implementierst eine Ziel-Allowlist und einen Transport, der nicht durch Weiterleitungen oder DNS-Rebinding umgangen werden kann.

Entwicklung

python -m pip install -e ".[dev]"
ruff check . && ruff format --check .
pytest
python -m build

MIT — siehe LICENSE.