Document http.maxRequestBodySize (REST, MCP application endpoint, and operations API body limits)
メンテナーはふだん 4 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 2/5
- 見積もり時間
- 1〜3時間
- 初心者へのやさしさ
- 88/100
- issue の種類
- ドキュメント
- 明瞭さ
- 明確に書かれている
- 活発さ
- 活発
調査の方向性
まず reference/configuration/options.md から始め、issue に記載されたデフォルト値と継承動作に基づいて http.maxRequestBodySize と operationsApi.network.maxRequestBodySize を文書化してください。次に、既存のレート制限に関する注記の位置を確認して、MCP の本文サイズ制限に関する注記を reference/mcp/overview.md に追加してください。3 つすべての適用箇所と、記載されているバージョンに関する注意事項が正確に文書化されていれば完了です。
索引モデルが issue の本文から書いたものです。
説明
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).
- 主要言語
- MDX
- スター
- 9
- フォーク
- 9
- 平均マージ
- 5日 5時間
- マージ済み PR(30日)
- 48
環境構築
- Dockerfile・Docker Compose ファイルなし
- プルリクエストのテンプレートなし
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
HarperFast/documentation のほかの issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
HarperFast/documentation#803 ·
メンテナーはふだん 4 日以内に返信
-
content
難易度 2/5 1〜3時間 初心者へのやさしさ 65/100
HarperFast/documentation#785 ·
メンテナーはふだん 4 日以内に返信
-
content
難易度 2/5 半日 初心者へのやさしさ 68/100
HarperFast/documentation#770 ·
メンテナーはふだん 4 日以内に返信
-
content
難易度 2/5 1〜3時間 初心者へのやさしさ 74/100
HarperFast/documentation#769 ·
メンテナーはふだん 4 日以内に返信
-
難易度 1/5 1時間未満 初心者へのやさしさ 76/100
HarperFast/documentation#768 ·
メンテナーはふだん 4 日以内に返信
HarperFast/documentation の issue をすべて見る
似ている issue
-
入群码过期オープン
難易度 1/5 1時間未満 初心者へのやさしさ 84/100
aliyun/ai-agent-handbook#29 · コメント 1 件 ·
-
docs documentation need-triage SaaS
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
メンテナーはふだん 1 日以内に返信
-
[Sync EN] stream: document the errors of the stream_context_*() and stream filter functions (#6091)オープンsync-en
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
メンテナーはふだん 1 日以内に返信
-
[Sync EN] stream: document the errors of the stream_context_*() and stream filter functions (#6091)オープンsync-en
難易度 2/5 1〜3時間 初心者へのやさしさ 66/100
メンテナーはふだん 1 日以内に返信
-
documentation
難易度 2/5 1〜3時間 初心者へのやさしさ 73/100
sleepyviper1213/redis#30 ·