Document http.maxRequestBodySize (REST, MCP application endpoint, and operations API body limits)
Maintainer antworten meist innerhalb von 4 Tagen
Dieses Issue hat noch niemand übernommen.
Bewertung
- Schwierigkeit
- 2/5
- Geschätzter Aufwand
- 1-3 Stunden
- Anfängerfreundlichkeit
- 88/100
- Issue-Typ
- Dokumentation
- Klarheit
- Klar beschrieben
- Aktivitätsstatus
- Aktiv
- Bereich
- documentation
Rechercherichtung
Beginne mit reference/configuration/options.md und dokumentiere http.maxRequestBodySize und operationsApi.network.maxRequestBodySize anhand der im Issue beschriebenen Standardwerte und des Vererbungsverhaltens. Füge dann den Hinweis zum MCP-Body-Limit in reference/mcp/overview.md hinzu und orientiere dich für die Platzierung am vorhandenen Hinweis zur Ratenbegrenzung. Fertig ist es, wenn alle drei Durchsetzungspunkte und der angegebene Versionsvorbehalt korrekt dokumentiert sind.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Beschreibung
Re-verified on harper
maina7dae444c (2026-10-26). Correction to the version note below: MCP application-endpoint enforcement merged as harper#3398 on 2026-10-26 and ships in 5.4; the v5.3 cherry-pick (harper#3536) is still open, so say "5.4 (and 5.3.x once #3536 ships)" rather than 5.3.1. Re-checked against harper main a7dae444c: the three enforcement points are unchanged. Related: harper#3397 (bound the discard of a rejected body).
What is missing
http.maxRequestBodySize does not appear anywhere in the documentation tree (git grep -i maxrequestbody at origin/main 34b029d9 → 0 hits). reference/configuration/options.md:156 lists the operationsApi: block without network.maxRequestBodySize; reference/mcp/configuration.md and reference/mcp/overview.md say nothing about a request-body limit.
What the code does (harper main 0c94b150b)
One option, three enforcement points:
- REST / any
streamToBufferreader —server/serverHelpers/contentTypes.ts:618readshttp_maxRequestBodySize(default 10,000,000 bytes);:626-634answers 413Request body too large, maximum size is N bytes. - MCP application endpoint — since PR #3398 (
f0f4e5007, 5.3.1):components/mcp/adapters/harperHttp.ts:68,117-137refuses a declaredContent-Lengthover the limit before any byte arrives and a streamed body once the running count exceeds it, 413{"error":"payload_too_large","message":…}. - Operations API — Fastify
bodyLimitfromoperationsApi.network.maxRequestBodySize(server/operationsServer.ts:50,368, default 1 GiB), whichconfig/configUtils.ts:1228fills fromhttp.*whenever theoperationsApi.networkblock exists — and the shippedstatic/defaultConfig.yaml:62-69always ships that block. So settinghttp.maxRequestBodySizealso caps the operations API unlessoperationsApi.network.maxRequestBodySizeis set separately.
Measured (SQA-73/SQA-74): with http.maxRequestBodySize: 65536, a REST PUT, an MCP POST on the application port and an MCP POST on the operations port all refuse at 65,537 bytes; with it unset, the operations port accepts up to 1 GiB.
Suggested content
In reference/configuration/options.md, under http: maxRequestBodySize — bytes, default 10000000; applies to REST and custom resources, and to the MCP application endpoint (5.3.1+); exceeding it returns 413. Under operationsApi.network: maxRequestBodySize — default inherits http.maxRequestBodySize when set, otherwise 1 GiB. One line in reference/mcp/overview.md beside the existing note that global rate limiting does not apply to MCP, stating that the body limit does.
Existing work checked
HarperFast/documentation issues and PRs searched for maxRequestBodySize and body size: nothing (open docs PRs #745, #739, #734 are credential masking, full-text paging, MCP subscribe). harper 1,500 issues + 800 PRs and harper-pro 349 + 768 titles: PR #3398 (merged) and harper#3397 (open, discard bound) name the key only in code terms; #3398 cites components/mcp/DESIGN.md, not the docs repo.
What this does not prove
A docs change in flight on a branch other than origin/main as of 34b029d9 (fetched 2026-10-26T04:10Z); the operations-port fallback for a hand-edited config with no operationsApi.network block (source read only, not measured).
- Vorherrschende Sprache
- MDX
- Sterne
- 9
- Forks
- 9
- Ø Merge
- 5 T. 5 Std.
- Gemergte PRs (30 T.)
- 48
Entwicklungsumgebung
- Kein Dockerfile und keine Docker-Compose-Datei
- Keine Pull-Request-Vorlage
- Beitragsleitfaden lesen
Erste Schritte
- Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
- Forken Sie das Repository und arbeiten Sie in einem Branch.
- Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.
Mehr aus HarperFast/documentation
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 68/100
HarperFast/documentation#803 ·
Maintainer antworten meist innerhalb von 4 Tagen
-
content
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 65/100
HarperFast/documentation#785 ·
Maintainer antworten meist innerhalb von 4 Tagen
-
content
Schwierigkeit 2/5 Ein halber Tag Anfängerfreundlichkeit 68/100
HarperFast/documentation#770 ·
Maintainer antworten meist innerhalb von 4 Tagen
-
content
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 74/100
HarperFast/documentation#769 ·
Maintainer antworten meist innerhalb von 4 Tagen
-
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 76/100
HarperFast/documentation#768 ·
Maintainer antworten meist innerhalb von 4 Tagen
Alle Issues in HarperFast/documentation
Ähnliche Issues
-
audit-reference-check
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
Maintainer antworten meist innerhalb von 1 Tag
-
[Docs]: Document the `timezone` ELN key for timestamps without a time zoneEvtl. vergeben @keila-moral hat das heute übernommen. Offendocumentation
Schwierigkeit 1/5 1-3 Stunden Anfängerfreundlichkeit 88/100
FAIRmat-NFDI/pynxtools-spm#134 ·
Maintainer antworten meist innerhalb von 1 Tag
-
from.page-issue
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 72/100
Maintainer antworten meist innerhalb von 1 Tag
-
feedback simulation workshop
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 69/100
githubnext/gh-aw-workshop#5826 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 1/5 1-3 Stunden Anfängerfreundlichkeit 66/100
philippe-nougaillon/coopcomm#543 ·