hatena-blog-mcp

はてなブログの記事を作成・更新するための MCP サーバー。 はてなブログ AtomPub API を薄くラップし、 AI エージェントから記事の下書き・推敲・公開を扱えるようにする。

セットアップ

パッケージマネージャは pnpm を使う（packageManager フィールドで固定）。

pnpm install   # 依存のインストールと同時に prepare で dist がビルドされる

設定値の取得

はてなブログの [設定] > [詳細設定] > [AtomPub] に「ルートエンドポイント」と「API キー」が表示される。 ルートエンドポイントは次の形式になっている。

https://blog.hatena.ne.jp/{ブログ所有者のはてなID}/{ブログID}/atom

• 自分が所有するブログなら所有者と操作者が同じなので、HATENA_BLOG_OWNER_ID は不要

• 共有ブログ（会社のテックブログなど）では、所有者と操作者が異なる。この場合は HATENA_BLOG_OWNER_ID にブログ所有者の ID を、HATENA_ID には自分のアカウントを指定する

• 有料プランで独自ドメインを使っている場合も、HATENA_BLOG_ID は独自ドメイン設定前のドメインを指定する

.env.example を参照。

MCP クライアントへの登録

Claude Code の場合:

# 自分が所有するブログ
claude mcp add hatena-blog -s user \
  -e HATENA_ID=your-hatena-id \
  -e HATENA_BLOG_ID=your-blog.hatenablog.com \
  -e HATENA_API_KEY=your-api-key \
  -- node /absolute/path/to/hatena-blog-mcp/dist/index.js

# 共有ブログ（所有者と操作者が異なる場合は HATENA_BLOG_OWNER_ID を足す）
claude mcp add hatena-blog -s user \
  -e HATENA_ID=your-hatena-id \
  -e HATENA_BLOG_OWNER_ID=blog-owner-id \
  -e HATENA_BLOG_ID=blog-owner-id.hatenablog.com \
  -e HATENA_API_KEY=your-api-key \
  -- node /absolute/path/to/hatena-blog-mcp/dist/index.js

-s user を付けると全プロジェクトで使える。-s project は使わないこと（.mcp.json に API キーが書き出される）。

設定ファイルに直接書く場合:

{
  "mcpServers": {
    "hatena-blog": {
      "command": "node",
      "args": ["/absolute/path/to/tech-blog/dist/index.js"],
      "env": {
        "HATENA_ID": "your-hatena-id",
        "HATENA_BLOG_OWNER_ID": "blog-owner-id",
        "HATENA_BLOG_ID": "blog-owner-id.hatenablog.com",
        "HATENA_API_KEY": "your-api-key"
      }
    }
  }
}

登録できたら get_blog_info を呼ぶと疎通確認になる。

Related MCP server: Blogger MCP Server

ツール

ブログ全体

記事

固定ページ

list_pages / search_pages / get_page / create_page / update_page が記事と同じ形で用意されている。 固定ページははてなブログの有料プランでのみ利用できる（無料プランでは 404 が返る）。 固定ページはカテゴリを持たないため、categories パラメータはない。

設計上の決めごと

削除は実装しない

記事・固定ページの削除（DELETE）は API 側にはあるが、意図的にツールとして公開していない。 誤操作の影響が大きく、取り消せないため。削除はブラウザから行う。

update_entry は差分更新

AtomPub の PUT は「送った内容で全体を置き換える」ため、タイトルだけ直すつもりでも 本文・カテゴリ・投稿日時をすべて送り直す必要がある。 このサーバーは update_entry の中で GET してから指定された項目だけを差し替えて PUT している。

• 省略した項目は現在の値がそのまま維持される

• updated を省略すると記事の投稿日時（表示される日付）は変わらない

• categories を渡した場合は置き換えになる（追加ではない）。既存カテゴリを残したいときは既存分も含めて渡す

新規作成は既定で下書き

create_entry の draft は既定 true。エージェントの操作でいきなり記事が公開されるのを避けるため、 公開は明示的に draft: false を指定したときだけ行われる。

本文の記法

content_type には text/x-markdown / text/x-hatena-syntax / text/html / text/plain を指定できる（既定は text/x-markdown）。 ただし実際にどう解釈されるかはブログ側の「編集モード」設定に従うため、ブログの設定と揃えて書く必要がある。 既存記事の更新では、編集前の記法が引き継がれる。

予約投稿

create_entry で draft: true + scheduled: true + 未来日時の updated を指定する。

一覧のページング

はてなブログの API は 1 ページあたりの件数が少なく、件数は API 側で決まる （公式ドキュメントは記事 7 件と記載しているが、実際には 10 件返ることを確認している）。 list_entries は 1 ページ分を返し、next_page を次の呼び出しの page に渡すと続きが取れる。 まとめて探したいときは、内部でページを辿る search_entries を使う。max_pages で走査量を制御する。

認証と、URL のはてなID

WSSE 認証（X-WSSE ヘッダ）を使う。リクエストごとに Nonce と Created を生成し、 Base64(SHA1(Nonce + Created + APIキー)) を PasswordDigest として送る。

エンドポイント URL のはてなID（ブログ所有者）と、認証するアカウントは別物である点に注意。 API キーはブログ単位ではなくアカウント単位で発行されるため、共有ブログでは

• URL: https://blog.hatena.ne.jp/{所有者のID}/{ブログID}/atom

• 認証: 自分のアカウントの はてなID + API キー

という組み合わせになる。両者を混同すると 401（キーが所有者のものでない）や 403（そのアカウントにブログの権限がない）になる。 このサーバーは HATENA_BLOG_OWNER_ID と HATENA_ID で両者を分離しており、 省略時は同一 ID として扱うので、自分のブログでも共有ブログでも同じ設定方法で動く。

スコープ外

• 画像のアップロード: AtomPub の範囲外（はてなフォトライフ API が別にある）

• 固定ページのレイアウト変更: API 非対応。ブラウザから設定する

• OAuth 認証: API キーによる WSSE 認証のみ対応

開発

pnpm run typecheck   # 型チェック
pnpm test            # ユニットテスト（API はモック）
pnpm run build       # dist へビルド
pnpm run dev         # ビルドせずに起動
pnpm run inspect     # MCP Inspector で手動確認

pnpm 10 は依存のビルドスクリプトを既定でブロックするため、tsx が使う esbuild だけを package.json の pnpm.onlyBuiltDependencies で許可している。

構成

src/
  index.ts          エントリポイント（stdio トランスポート）
  server.ts         McpServer の組み立て
  config.ts         環境変数の読み込み
  hatena/
    client.ts       AtomPub の HTTP クライアント
    wsse.ts         WSSE 認証ヘッダの生成
    atom.ts         Atom XML のパース・生成
    types.ts        ドメイン型
  tools/
    blog.ts         ブログ全体に対するツール
    collection.ts   記事・固定ページ共通のツール定義
    shared.ts       ツールの共通ヘルパー

記事と固定ページは AtomPub 上ほぼ同じ構造なので、tools/collection.ts の registerCollectionTools を記事用・固定ページ用の 2 通りの設定で呼び分けている。

ライセンス

MIT License. 詳細は LICENSE を参照。