@kagayoi/hatena-blog-mcp 0.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md ADDED
@@ -0,0 +1,317 @@
1
+ # hatena-blog-mcp
2
+
3
+ 日本語 | [English README](./README.en.md)
4
+
5
+ [![npm version](https://img.shields.io/npm/v/@kagayoi/hatena-blog-mcp)](https://www.npmjs.com/package/@kagayoi/hatena-blog-mcp)
6
+
7
+ > [!IMPORTANT]
8
+ > このリポジトリは [Keisuke69/hatena-blog-mcp](https://github.com/Keisuke69/hatena-blog-mcp) をフォークし、独自に保守している非公式の派生版です。はてなフォトライフ対応、更新競合の検出、入力・レスポンス上限、Cloudflare Workers 向けの堅牢化など、フォーク固有の変更を含みます。これらの変更に関する Issue は[このフォーク](https://github.com/1llum1n4t1s/KG.hatena-blog-mcp/issues)へ報告してください。変更内容は [CHANGELOG.md](./CHANGELOG.md) にまとめています。
9
+
10
+ [はてなブログ AtomPub API](https://developer.hatena.ne.jp/ja/documents/blog/apis/atom) と [はてなフォトライフ AtomAPI](https://developer.hatena.ne.jp/ja/documents/fotolife/apis/atom/) を **読み書き両対応** でラップした MCP (Model Context Protocol) サーバーです。**Cloudflare Workers** 上で動かすことを想定し、**BYOK (Bring Your Own Key)** モデルを採用しています。
11
+
12
+ もともとのユースケースは「Claude にブログ全記事のカテゴリを一括で付け替えてもらう」こと。タイトル・本文・投稿日時を誤って書き換えずに、カテゴリだけを安全に更新できるように設計されています。
13
+
14
+ ## 特徴
15
+
16
+ - エントリ: `list_entries`, `get_entry`, `create_entry`, `update_entry`, `delete_entry`
17
+ - 固定ページ: `list_pages`, `get_page`, `create_page`, `update_page`, `delete_page`
18
+ - カテゴリ: `list_categories`
19
+ - 画像: `get_image`, `upload_image`
20
+ - **安全な部分更新**: `update_entry` / `update_page` は、明示的に変更しない限り既存のタイトル・本文・記法・投稿日時・スラッグを維持します。本文の `content_type` は常に既存エントリの値を使うため、Markdown がプレーンテキストに黙って切り替わることもありません。
21
+ - サーバー側に一切の状態を持たない — 認証情報はリクエストごとの `Authorization` ヘッダにのみ存在します。
22
+
23
+ ## トランスポート
24
+
25
+ - **MCP Streamable HTTP のみ** (`POST /mcp`、JSON レスポンスモード)
26
+ - stdio は非対応 — stdio しか喋れないクライアントでは [`mcp-remote`](https://github.com/geelen/mcp-remote) を介してください
27
+ - SSE は非対応
28
+
29
+ ## エンドポイント
30
+
31
+ | メソッド | パス | 用途 |
32
+ | --- | --- | --- |
33
+ | `POST` | `/mcp` | MCP Streamable HTTP のエントリポイント |
34
+ | `OPTIONS` | `/mcp` | CORS プリフライト |
35
+ | `GET` | `/` | ヘルスチェック / サーバー情報の JSON |
36
+
37
+ ---
38
+
39
+ ## クイックスタート: Cloudflare Workers へのデプロイ
40
+
41
+ ### 前提条件
42
+
43
+ - Node.js 22 以上
44
+ - Cloudflare アカウントと、Workers をデプロイできる権限
45
+
46
+ ### npmパッケージから利用する
47
+
48
+ ```sh
49
+ mkdir my-hatena-blog-mcp
50
+ cd my-hatena-blog-mcp
51
+ npm init -y
52
+ npm install @kagayoi/hatena-blog-mcp
53
+ npm install --save-dev wrangler
54
+ ```
55
+
56
+ `src/index.ts` を作成し、パッケージのWorkerを再exportします。
57
+
58
+ ```ts
59
+ export { default } from "@kagayoi/hatena-blog-mcp";
60
+ ```
61
+
62
+ `wrangler.jsonc` には利用者自身のWorker名と設定を記載します。
63
+
64
+ ```jsonc
65
+ {
66
+ "$schema": "node_modules/wrangler/config-schema.json",
67
+ "name": "my-hatena-blog-mcp",
68
+ "main": "src/index.ts",
69
+ "compatibility_date": "2026-08-24",
70
+ "compatibility_flags": ["nodejs_compat", "enable_request_signal", "request_signal_passthrough"],
71
+ "vars": {
72
+ "ALLOWED_ORIGINS": ""
73
+ },
74
+ "observability": {
75
+ "enabled": true
76
+ }
77
+ }
78
+ ```
79
+
80
+ ```sh
81
+ npx wrangler login
82
+ npx wrangler deploy
83
+ ```
84
+
85
+ npmパッケージはCloudflare Workers用のモジュールです。`npx @kagayoi/hatena-blog-mcp` で起動するstdioサーバーではありません。
86
+
87
+ ### ソースリポジトリから利用する
88
+
89
+ この方法では pnpm 10 以上を使用します。
90
+
91
+ ```sh
92
+ git clone https://github.com/1llum1n4t1s/KG.hatena-blog-mcp.git
93
+ cd KG.hatena-blog-mcp
94
+ pnpm install
95
+ pnpm exec wrangler login
96
+ pnpm exec wrangler deploy
97
+ ```
98
+
99
+ 以上です。シークレットも KV も Durable Objects も不要 — 認証情報はクライアントがリクエストごとに渡します。URL は `https://hatena-blog-mcp.<あなたのサブドメイン>.workers.dev` のような形になります。
100
+
101
+ ### オプションの Wrangler 変数
102
+
103
+ | 変数 | デフォルト | 説明 |
104
+ | --- | --- | --- |
105
+ | `ALLOWED_ORIGINS` | 空文字 → `*` | カンマ区切りの CORS 許可オリジンリスト (例: `https://claude.ai,https://chatgpt.com`)。値を設定すると、リスト外の明示的な `Origin` を preflight を含め 403 で拒否します。空文字は幅広い MCP クライアントとの互換性を保つ既定値です。 |
106
+
107
+ `wrangler.jsonc` の `vars` を編集してから通常どおり deploy してください。コマンドラインだけの `--var` は、次回の通常 deploy で消えるため使いません。
108
+
109
+ ```jsonc
110
+ "vars": {
111
+ "ALLOWED_ORIGINS": "https://claude.ai,https://chatgpt.com"
112
+ }
113
+ ```
114
+
115
+ ---
116
+
117
+ ## 認証 (BYOK)
118
+
119
+ このサーバーは **認証情報を一切保存しません**。各リクエストには以下を必ず含めてください:
120
+
121
+ ```
122
+ Authorization: Basic base64(hatena_id:api_key)
123
+ ```
124
+
125
+ API キーは **はてなブログ → 設定 → 詳細設定 → AtomPub** から取得できます。`hatena_id` はブログ URL の左側部分 (`<hatena_id>.hatenablog.com`) です。
126
+
127
+ 同じ Worker を複数人で共有して、それぞれが自分の API キーを使うこともできます。
128
+
129
+ ---
130
+
131
+ ## クライアント設定
132
+
133
+ ### Claude Desktop / Claude.ai Web / モバイル (ネイティブのリモート MCP)
134
+
135
+ 新しいリモート MCP サーバーを追加して、Worker の URL を指定します:
136
+
137
+ - **URL**: `https://hatena-blog-mcp.<あなたのサブドメイン>.workers.dev/mcp`
138
+ - **Auth**: Basic 認証、ユーザー名 = はてなID、パスワード = AtomPub API キー
139
+
140
+ ### Claude Code (または stdio しか話せないクライアント) を `mcp-remote` 経由で
141
+
142
+ `mcp-remote` はローカルで stdio ↔ Streamable HTTP をブリッジします:
143
+
144
+ ```jsonc
145
+ // ~/.claude.json または各クライアントの設定ファイル
146
+ {
147
+ "mcpServers": {
148
+ "hatena-blog": {
149
+ "command": "npx",
150
+ "args": [
151
+ "mcp-remote",
152
+ "https://hatena-blog-mcp.<あなたのサブドメイン>.workers.dev/mcp",
153
+ "--header",
154
+ "Authorization: Basic ${BASIC_AUTH}"
155
+ ],
156
+ "env": {
157
+ "BASIC_AUTH": "<base64(hatena_id:api_key)>"
158
+ }
159
+ }
160
+ }
161
+ }
162
+ ```
163
+
164
+ Base64 値は `printf '%s' 'hatena_id:api_key' | base64` で生成します。
165
+
166
+ ### MCP Inspector (手動での動作確認用)
167
+
168
+ ```sh
169
+ pnpm exec wrangler dev # 別ターミナルで起動
170
+ npx @modelcontextprotocol/inspector
171
+ ```
172
+
173
+ Inspector では **Streamable HTTP** を選択し、URL に `http://localhost:8787/mcp`、カスタムヘッダに `Authorization: Basic <base64>` を設定します。
174
+
175
+ ---
176
+
177
+ ## ツールリファレンス
178
+
179
+ ブログ・固定ページ・カテゴリのツールは必須引数として `blog_id` (例: `example.hatenablog.com`) を取り、任意で `hatena_id` を指定できます (`Authorization` ヘッダのユーザー名を上書き — グループブログで便利)。画像ツールは認証ヘッダのはてなIDに紐づくフォトライフを操作するため `blog_id` は不要です。
180
+
181
+ ### エントリ
182
+
183
+ | 名前 | 用途 | 必須 | 主なオプション |
184
+ | --- | --- | --- | --- |
185
+ | `list_entries` | エントリ一覧 (1ページ7件) | `blog_id` | `page`, `include_html` |
186
+ | `get_entry` | 1件取得 | `blog_id`, `entry_id` | `include_html` |
187
+ | `create_entry` | 新規投稿 | `blog_id`, `title`, `content` | `content_type`, `eyecatch_image_url`, `categories`, `draft`, `preview`, `scheduled` (`true` には `draft: true` + `updated` が必須), `custom_url` |
188
+ | `update_entry` | **部分更新** | `blog_id`, `entry_id` | `title`, `content`, `eyecatch_image_url`, `categories` (`[]` でクリア), `draft`, `preview`, `custom_url`, `touch_updated`, `expected_edited` |
189
+ | `delete_entry` | 削除 | `blog_id`, `entry_id` | — |
190
+
191
+ `update_entry` の仕様:
192
+ - 省略したフィールドは既存エントリの値を維持します。
193
+ - `content_type` は **常に** 既存エントリから取得 — このツール経由で Markdown ↔ プレーンテキストを切り替えることはできません。
194
+ - `updated` は `touch_updated: true` のときだけ送信されます (デフォルト: 投稿日時を維持)。
195
+ - `custom_url` は明示指定した場合のみ送信されます (デフォルト: 既存スラッグを維持)。
196
+ - 直前の取得結果にある `edited` を `expected_edited` に渡すと、取得済みの版から変更されていた場合は PUT せず競合エラーにします。はてな API に条件付き PUT はないため、サーバー側 GET と PUT の間まで原子的に保証するものではありません。
197
+
198
+ #### 本文先頭画像による自動アイキャッチ
199
+
200
+ `create_entry` または `update_entry` に任意の `eyecatch_image_url` を渡すと、その HTTP(S) 画像を本文先頭へ挿入します。はてなブログが「本文の最初の画像」を自動採用する仕組みを利用するため、編集画面の公式アイキャッチ項目を直接設定する機能ではありません。画像は記事本文にも表示されます。
201
+
202
+ ```json
203
+ {
204
+ "name": "create_entry",
205
+ "arguments": {
206
+ "blog_id": "example.hatenablog.com",
207
+ "title": "自動アイキャッチ付きの記事",
208
+ "content": "### 本文\n\nここから記事本文です。",
209
+ "content_type": "text/x-markdown",
210
+ "eyecatch_image_url": "https://cdn-ak.f.st-hatena.com/images/fotolife/example.png"
211
+ }
212
+ }
213
+ ```
214
+
215
+ - `upload_image` が返す `image_url` を、そのまま `eyecatch_image_url` に渡せます。
216
+ - オプションを省略した場合、本文は変更されません。
217
+ - `update_entry` で本文を省略した場合は既存本文へ追加します。このMCPが以前追加した自動アイキャッチブロックがあれば、新しい画像へ置換して重複を防ぎます。
218
+ - 挿入後の本文にも4 MiBの上限が適用されます。
219
+
220
+ ### 固定ページ
221
+
222
+ エントリとほぼ同じ形ですが、`categories` と `scheduled` はありません。`create_page` では `custom_url` が必須です (はてなはこれをページの恒久的なスラッグとして扱います)。`update_page` でも `expected_edited` を競合検出に利用できます。
223
+
224
+ ### カテゴリ
225
+
226
+ - `list_categories` → `{ categories: string[], fixed: boolean }`。`fixed: true` の場合、このブログでは新しいカテゴリを追加できません。
227
+
228
+ ### 画像 (はてなフォトライフ)
229
+
230
+ | 名前 | 用途 | 必須 | 主なオプション |
231
+ | --- | --- | --- | --- |
232
+ | `get_image` | 画像メタデータを1件取得 | `image_id` | — |
233
+ | `upload_image` | 画像を投稿し、記事用 `blog_syntax` を取得 | `title`, `content_type`, `data_base64` | `folder` (既定: `Hatena Blog`) |
234
+
235
+ 画像操作の認証は、リクエストの Basic 認証情報からリクエストごとに WSSE を生成します。APIキーをサーバーへ保存しません。重複投稿を避けるため `upload_image` の POST は自動リトライしません。
236
+
237
+ 画像はデコード後 10 MiB までです。MCP リクエストは 16 MiB、はてなから受け取る XML は 8 MiB、エラーボディは 16 KiB に制限しています。
238
+
239
+ フォトライフ公式feedはブログ編集画面から投稿した非公開「Hatena Blog」フォルダを列挙しないため、一覧ツールは提供しません。記事本文のfotolife記法から画像IDを取得し、`get_image` で確認してください。
240
+
241
+ ---
242
+
243
+ ## 使用例: カテゴリの一括付け替え (本プロジェクトの原点)
244
+
245
+ MCP サーバーを接続したら、Claude に次のように頼むだけです:
246
+
247
+ > 「私のブログ `example.hatenablog.com` の全エントリを `list_entries` で列挙して、各エントリの本文を読んだうえで既存カテゴリを整理し直してください。タイトル・本文・投稿日時は絶対に変更しないでください。」
248
+
249
+ `update_entry` は既存値を取得してからマージするため、Claude は更新対象と直前に確認した `edited` を次のように渡せます:
250
+
251
+ ```json
252
+ {
253
+ "name": "update_entry",
254
+ "arguments": {
255
+ "blog_id": "example.hatenablog.com",
256
+ "entry_id": "3000000000000000010",
257
+ "expected_edited": "2026-04-18T10:15:00+09:00",
258
+ "categories": ["技術", "TypeScript", "Cloudflare"]
259
+ }
260
+ }
261
+ ```
262
+
263
+ …本文を書き換えたり、Markdown をプレーンテキストに切り替えたり、投稿日時を今日にずらしたりすることなく。
264
+
265
+ ---
266
+
267
+ ## 開発
268
+
269
+ ```sh
270
+ pnpm install
271
+ pnpm dev # wrangler dev を http://localhost:8787 で起動
272
+ pnpm test # vitest
273
+ pnpm test:coverage # 全体60%、xml.ts 90%、entries.ts 90% (branch 75%) 以上
274
+ pnpm lint # biome check
275
+ pnpm lint:fix # biome check --write
276
+ pnpm typecheck # tsc --noEmit
277
+ pnpm types:worker # wrangler.jsonc から Worker 型を再生成
278
+ pnpm exec wrangler deploy --dry-run --outdir .wrangler/dry-run # バンドル確認
279
+ ```
280
+
281
+ ### ディレクトリ構成
282
+
283
+ ```
284
+ src/
285
+ atompub/ — はてな AtomPub API のステートレス HTTP クライアント
286
+ fotolife/ — WSSE 認証 + はてなフォトライフ AtomAPI クライアント
287
+ mcp/
288
+ tools/ — entries.ts, pages.ts, categories.ts, images.ts (ツール群別ファイル)
289
+ server.ts — createServer() で 13 個のツールを新規 McpServer に登録
290
+ context.ts — リクエストごとの認証情報 + クライアント生成
291
+ response.ts — ToolTextResult、日本語エラー、秘密を除いた構造化ログ
292
+ adapters/cloudflare/
293
+ index.ts — Hono アプリ: CORS → BYOK 認証 → Streamable HTTP トランスポート
294
+ utils/
295
+ auth.ts — parseBasicAuth
296
+ body.ts — リクエスト/レスポンスボディのサイズ制限
297
+ retry.ts — 冪等メソッド限定の指数バックオフ + jitter、Retry-After を尊重
298
+ test/
299
+ fixtures/ — 実 AtomPub レスポンスのサンプル
300
+ ...
301
+ ```
302
+
303
+ ---
304
+
305
+ ## セキュリティに関する注意
306
+
307
+ - **このサーバーは `Authorization` をそのまま中継します。** 認証情報はヘッダからデコードされて Worker に届き、各 AtomPub 呼び出しではてな側へ流れます。永続ストレージには書きませんが、それでも信頼できる場所にホストしてください。悪意ある、あるいは乗っ取られた Worker を経由すれば、通過するすべてのキーがログや悪用の対象になり得ます。
308
+ - **ログは認証情報・エラーメッセージ・レスポンスボディを意図的に除いています。** `console.*` には操作名、リクエストID、ステータスコード、エラーカテゴリ/型だけを残します。ログを追加するときもこの方針を守ってください。
309
+ - **CORS は互換性のためデフォルトで全開放です。** 認証はクッキーではなく `Authorization` で行い、`Access-Control-Allow-Credentials` は付けません。ブラウザクライアントを限定できる環境では `ALLOWED_ORIGINS` の設定を推奨します。設定時はリスト外の明示的な `Origin` を 403 で拒否します。`Origin` のない非ブラウザ要求は許可し、`Host` は別途制限しないため、必要なら前段プロキシでも制約してください。
310
+ - **レート制限と濫用対策。** URL を知っている人なら誰でも叩ける公開デプロイは負荷にさらされ得ます。Cloudflare の無料プランにもグローバルな制限はありますが、必要に応じて Wrangler の `[limits]` ブロックや WAF のレート制限ルールを検討してください。
311
+ - **API キーが漏洩したら**、*はてなブログ → 設定 → 詳細設定 → AtomPub* から失効・再発行してください。本サーバー側でクリアするものは何もありません。
312
+
313
+ ---
314
+
315
+ ## ライセンス
316
+
317
+ MIT。フォーク元の著作権表示を含む全文は [LICENSE](./LICENSE) を参照してください。
package/package.json ADDED
@@ -0,0 +1,72 @@
1
+ {
2
+ "name": "@kagayoi/hatena-blog-mcp",
3
+ "version": "0.0.2",
4
+ "description": "Kagayoi-maintained Hatena Blog and Fotolife MCP server for Cloudflare Workers with BYOK.",
5
+ "license": "MIT",
6
+ "author": "Keisuke Nishitani",
7
+ "repository": {
8
+ "type": "git",
9
+ "url": "git+https://github.com/1llum1n4t1s/KG.hatena-blog-mcp.git"
10
+ },
11
+ "homepage": "https://github.com/1llum1n4t1s/KG.hatena-blog-mcp#readme",
12
+ "bugs": {
13
+ "url": "https://github.com/1llum1n4t1s/KG.hatena-blog-mcp/issues"
14
+ },
15
+ "keywords": [
16
+ "mcp",
17
+ "model-context-protocol",
18
+ "hatena-blog",
19
+ "hatena-fotolife",
20
+ "cloudflare-workers",
21
+ "atompub"
22
+ ],
23
+ "type": "module",
24
+ "types": "./src/index.ts",
25
+ "exports": {
26
+ ".": "./src/index.ts"
27
+ },
28
+ "files": [
29
+ "src",
30
+ "wrangler.jsonc",
31
+ "tsconfig.json",
32
+ "README.en.md",
33
+ "CHANGELOG.md",
34
+ "DESIGN.md"
35
+ ],
36
+ "publishConfig": {
37
+ "access": "public"
38
+ },
39
+ "packageManager": "pnpm@10.11.1",
40
+ "engines": {
41
+ "node": ">=22.0.0",
42
+ "pnpm": ">=10.0.0"
43
+ },
44
+ "scripts": {
45
+ "dev": "wrangler dev",
46
+ "deploy": "wrangler deploy",
47
+ "build": "tsc --noEmit",
48
+ "typecheck": "tsc --noEmit",
49
+ "test": "vitest run",
50
+ "test:watch": "vitest",
51
+ "test:coverage": "vitest run --coverage",
52
+ "types:worker": "wrangler types src/worker-configuration.d.ts --env-interface Env --strict-vars=false",
53
+ "lint": "biome check .",
54
+ "lint:fix": "biome check --write .",
55
+ "prepublishOnly": "pnpm lint && pnpm typecheck && pnpm test:coverage && pnpm exec wrangler types src/worker-configuration.d.ts --env-interface Env --strict-vars=false --check && pnpm exec wrangler deploy --dry-run --outdir .wrangler/dry-run"
56
+ },
57
+ "dependencies": {
58
+ "@modelcontextprotocol/sdk": "^1.18.0",
59
+ "fast-xml-parser": "^5.2.0",
60
+ "hono": "^4.9.0",
61
+ "zod": "^4.3.6"
62
+ },
63
+ "devDependencies": {
64
+ "@biomejs/biome": "^2.2.0",
65
+ "@cloudflare/workers-types": "^4.20250409.0",
66
+ "@types/node": "^25.6.0",
67
+ "@vitest/coverage-v8": "^3.2.0",
68
+ "typescript": "^5.9.0",
69
+ "vitest": "^3.2.0",
70
+ "wrangler": "^4.12.0"
71
+ }
72
+ }
@@ -0,0 +1,179 @@
1
+ import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
2
+ import { Hono } from "hono";
3
+ import type { ToolContext } from "../../mcp/context.js";
4
+ import { createServer } from "../../mcp/server.js";
5
+ import { MissingCredentialsError, parseBasicAuth } from "../../utils/auth.js";
6
+ import { ResponseBodyTooLargeError, readBytesWithLimit } from "../../utils/body.js";
7
+ import { MAX_MCP_REQUEST_BYTES } from "../../utils/limits.js";
8
+
9
+ // ---------------------------------------------------------------------------
10
+ // CORS
11
+ // ---------------------------------------------------------------------------
12
+ // Web/モバイルから直接叩けるよう `*` で開けつつ、BYOK の Authorization ヘッダを
13
+ // 通すために preflight で明示する。credentials は使わない (Authorization だけで
14
+ // 認証する設計) ので `Access-Control-Allow-Credentials` は付けない。
15
+ // 一般的なリモート MCP サーバの構成に合わせている。
16
+ //
17
+ // ALLOWED_ORIGINS (カンマ区切り) が空なら `*`、設定時は一致した Origin のみ
18
+ // エコーバックし、リスト外の明示的な Origin は 403 で拒否する。
19
+
20
+ const DEFAULT_ALLOW_HEADERS = "Authorization, Content-Type, Mcp-Session-Id, Mcp-Protocol-Version";
21
+ const DEFAULT_ALLOW_METHODS = "GET, POST, DELETE, OPTIONS";
22
+ const DEFAULT_EXPOSE_HEADERS = "Mcp-Session-Id";
23
+
24
+ function resolveAllowedOrigin(requestOrigin: string | null, allowlist?: string[]): string {
25
+ if (!allowlist || allowlist.length === 0) return "*";
26
+ if (requestOrigin && allowlist.includes(requestOrigin)) return requestOrigin;
27
+ // Requests with a disallowed explicit Origin are rejected before this helper.
28
+ return allowlist[0] ?? "*";
29
+ }
30
+
31
+ function parseAllowedOrigins(env: Env | undefined): string[] | undefined {
32
+ const raw = env?.ALLOWED_ORIGINS;
33
+ if (!raw) return undefined;
34
+ return raw
35
+ .split(",")
36
+ .map((s) => s.trim())
37
+ .filter((s) => s.length > 0);
38
+ }
39
+
40
+ // ---------------------------------------------------------------------------
41
+ // App factory (exported for tests; default export is the one-shot instance)
42
+ // ---------------------------------------------------------------------------
43
+
44
+ export function createApp() {
45
+ const app = new Hono<{ Bindings: Env }>();
46
+
47
+ app.use("*", async (c, next) => {
48
+ const allowlist = parseAllowedOrigins(c.env);
49
+ const requestOrigin = c.req.header("origin") ?? null;
50
+ if (allowlist && requestOrigin && !allowlist.includes(requestOrigin)) {
51
+ return new Response("Origin is not allowed.", {
52
+ status: 403,
53
+ headers: { Vary: "Origin" },
54
+ });
55
+ }
56
+ const origin = resolveAllowedOrigin(requestOrigin, allowlist);
57
+
58
+ if (c.req.method === "OPTIONS") {
59
+ return new Response(null, {
60
+ status: 204,
61
+ headers: {
62
+ "Access-Control-Allow-Origin": origin,
63
+ "Access-Control-Allow-Methods": DEFAULT_ALLOW_METHODS,
64
+ "Access-Control-Allow-Headers": DEFAULT_ALLOW_HEADERS,
65
+ "Access-Control-Expose-Headers": DEFAULT_EXPOSE_HEADERS,
66
+ "Access-Control-Max-Age": "86400",
67
+ Vary: "Origin",
68
+ },
69
+ });
70
+ }
71
+
72
+ await next();
73
+
74
+ c.res.headers.set("Access-Control-Allow-Origin", origin);
75
+ c.res.headers.set("Access-Control-Expose-Headers", DEFAULT_EXPOSE_HEADERS);
76
+ c.res.headers.set("Vary", "Origin");
77
+ return;
78
+ });
79
+
80
+ app.get("/", (c) =>
81
+ c.json({
82
+ name: "hatena-blog-mcp",
83
+ ok: true,
84
+ transport: "streamable-http",
85
+ endpoint: "/mcp",
86
+ }),
87
+ );
88
+
89
+ app.all("/mcp", async (c) => {
90
+ const contentLength = Number(c.req.header("content-length"));
91
+ if (Number.isFinite(contentLength) && contentLength > MAX_MCP_REQUEST_BYTES) {
92
+ return c.json(
93
+ {
94
+ jsonrpc: "2.0",
95
+ error: { code: -32002, message: "Request body is too large." },
96
+ id: null,
97
+ },
98
+ 413,
99
+ );
100
+ }
101
+
102
+ let transportRequest = c.req.raw;
103
+ if (c.req.method === "POST" && c.req.raw.body) {
104
+ try {
105
+ const body = await readBytesWithLimit(c.req.raw.body, MAX_MCP_REQUEST_BYTES);
106
+ transportRequest = new Request(c.req.raw.url, {
107
+ method: c.req.raw.method,
108
+ headers: c.req.raw.headers,
109
+ body,
110
+ signal: c.req.raw.signal,
111
+ });
112
+ } catch (err) {
113
+ if (err instanceof ResponseBodyTooLargeError) {
114
+ return c.json(
115
+ {
116
+ jsonrpc: "2.0",
117
+ error: { code: -32002, message: "Request body is too large." },
118
+ id: null,
119
+ },
120
+ 413,
121
+ );
122
+ }
123
+ throw err;
124
+ }
125
+ }
126
+
127
+ // Parse BYOK credentials once per request; the MCP server closes over them
128
+ // so every tool invocation inside this request relays the same header.
129
+ let ctx: ToolContext;
130
+ try {
131
+ const credentials = parseBasicAuth(c.req.header("authorization") ?? null);
132
+ ctx = {
133
+ credentials,
134
+ signal: c.req.raw.signal,
135
+ requestId: c.req.header("cf-ray") ?? crypto.randomUUID(),
136
+ };
137
+ } catch (err) {
138
+ if (err instanceof MissingCredentialsError) {
139
+ return c.json(
140
+ {
141
+ jsonrpc: "2.0",
142
+ error: {
143
+ code: -32001,
144
+ message: "Authorization header (Basic <base64(hatena_id:api_key)>) is required.",
145
+ },
146
+ id: null,
147
+ },
148
+ 401,
149
+ { "WWW-Authenticate": 'Basic realm="hatena-blog-mcp"' },
150
+ );
151
+ }
152
+ throw err;
153
+ }
154
+
155
+ const server = createServer(ctx);
156
+ // Stateless: omit sessionIdGenerator entirely (per SDK docs, this disables
157
+ // session management). Every request is independent.
158
+ const transport = new WebStandardStreamableHTTPServerTransport({
159
+ // JSON responses (no SSE) — Claude Desktop / Web / mobile all accept this
160
+ // and it's the simpler path for a stateless server on Workers.
161
+ enableJsonResponse: true,
162
+ });
163
+
164
+ try {
165
+ await server.connect(transport);
166
+ return await transport.handleRequest(transportRequest);
167
+ } finally {
168
+ // Fire-and-forget: closing is best-effort; we don't want cleanup errors
169
+ // to mask a successful response.
170
+ void transport.close().catch(() => {});
171
+ void server.close().catch(() => {});
172
+ }
173
+ });
174
+
175
+ return app;
176
+ }
177
+
178
+ const app = createApp();
179
+ export default app;