hatena-blog-mcp
hatena-blog-mcp
Servidor MCP para crear y actualizar artículos de Hatena Blog. Envuelve de forma ligera la API AtomPub de Hatena Blog y permite que los agentes de IA gestionen el borrador, la revisión y la publicación de artículos.
Configuración
El gestor de paquetes es pnpm (fijado en el campo packageManager).
pnpm install # 依存のインストールと同時に prepare で dist がビルドされるObtención de los valores de configuración
En [Configuración] > [Configuración avanzada] > [AtomPub] de Hatena Blog se muestran el «punto final raíz» y la «clave de API». El punto final raíz tiene el siguiente formato.
https://blog.hatena.ne.jp/{ブログ所有者のはてなID}/{ブログID}/atomVariable de entorno | Obligatoria | Valor |
| ○ | ID de Hatena de la cuenta utilizada para la autenticación (titular de la clave de API) |
| ○ | Parte |
| ○ | Clave de API |
| Parte |
Si el blog es propio, el propietario y el operador son la misma persona, por lo que
HATENA_BLOG_OWNER_IDno es necesario.En blogs compartidos (como el blog técnico de una empresa), el propietario y el operador son distintos. En ese caso, especifica el ID del propietario del blog en
HATENA_BLOG_OWNER_IDy tu propia cuenta enHATENA_ID.Si se usa un dominio propio con un plan de pago, en
HATENA_BLOG_IDse debe especificar el dominio anterior a la configuración del dominio propio.
Consulta .env.example.
Registro en el cliente MCP
En el caso de 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.jsCon -s user estará disponible en todos los proyectos. No uses -s project (la clave de API se escribirá en .mcp.json).
Si se escribe directamente en el archivo de configuración:
{
"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"
}
}
}
}Una vez registrado, llamar a get_blog_info sirve para comprobar la conexión.
Related MCP server: Blogger MCP Server
Herramientas
Blog completo
Herramienta | Descripción |
| Obtiene el título del blog y las colecciones disponibles (también sirve para comprobar la conexión) |
| Lista de categorías utilizadas en el blog |
Artículos
Herramienta | Descripción |
| Lista los artículos del más reciente al más antiguo (incluye borradores). Con |
| Recorre las páginas y busca coincidencias parciales en título, cuerpo y categorías |
| Obtiene un artículo (el cuerpo se devuelve en la notación registrada) |
| Crea un artículo nuevo (por defecto, como borrador) |
| Actualiza un artículo de forma diferencial |
Páginas fijas
list_pages / search_pages / get_page / create_page / update_page están disponibles con la misma forma que los artículos.
Las páginas fijas solo están disponibles en los planes de pago de Hatena Blog (en el plan gratuito se devuelve 404).
Las páginas fijas no tienen categorías, por lo que no existe el parámetro categories.
Decisiones de diseño
No se implementa la eliminación
La eliminación (DELETE) de artículos y páginas fijas existe en la API, pero deliberadamente no se expone como herramienta.
El impacto de un error de operación es grande y no se puede deshacer. La eliminación se realiza desde el navegador.
update_entry es una actualización diferencial
Como el PUT de AtomPub «reemplaza todo con el contenido enviado», incluso si solo se quiere corregir el título,
es necesario volver a enviar el cuerpo, las categorías y la fecha de publicación.
Este servidor, dentro de update_entry, hace GET y luego reemplaza solo los elementos especificados antes de hacer PUT.
Los elementos omitidos conservan su valor actual.
Si se omite
updated, la fecha de publicación del artículo (la fecha mostrada) no cambia.Si se pasan
categories, se produce un reemplazo (no una adición). Si se quieren conservar las categorías existentes, hay que incluirlas también.
La creación nueva es un borrador por defecto
El draft de create_entry es true por defecto. Para evitar que un artículo se publique de repente por una operación del agente,
la publicación solo se realiza cuando se especifica explícitamente draft: false.
Notación del cuerpo
En content_type se puede especificar text/x-markdown / text/x-hatena-syntax / text/html / text/plain (por defecto, text/x-markdown).
Sin embargo, cómo se interpreta realmente depende del ajuste de «modo de edición» del blog, por lo que hay que escribir de acuerdo con la configuración del blog.
Al actualizar un artículo existente, se conserva la notación anterior a la edición.
Publicación programada
En create_entry, especifica draft: true + scheduled: true + un updated con fecha y hora futuras.
Paginación de las listas
La API de Hatena Blog devuelve pocos elementos por página, y el número lo decide la API
(la documentación oficial indica 7 artículos, pero se ha confirmado que en realidad devuelve 10).
list_entries devuelve una página y, pasando next_page al parámetro page de la siguiente llamada, se obtiene la continuación.
Para buscar en conjunto, usa search_entries, que recorre las páginas internamente. max_pages controla la cantidad de recorrido.
Autenticación e ID de Hatena en la URL
Se usa autenticación WSSE (cabecera X-WSSE). En cada petición se generan Nonce y Created, y se envía
Base64(SHA1(Nonce + Created + Clave de API)) como PasswordDigest.
Ten en cuenta que el ID de Hatena de la URL del punto final (propietario del blog) y la cuenta que se autentica son cosas distintas. Como la clave de API se emite por cuenta y no por blog, en un blog compartido la combinación es:
URL:
https://blog.hatena.ne.jp/{ID del propietario}/{ID del blog}/atomAutenticación: ID de Hatena de tu propia cuenta + clave de API
Si se confunden ambos, se obtiene 401 (la clave no es del propietario) o
403 (esa cuenta no tiene permisos sobre el blog).
Este servidor separa ambos con HATENA_BLOG_OWNER_ID y HATENA_ID, y
si se omiten, se tratan como el mismo ID, por lo que funciona con el mismo método de configuración tanto para blogs propios como compartidos.
Fuera del alcance
Subida de imágenes: fuera del alcance de AtomPub (existe la API de Hatena Fotolife por separado)
Cambio de diseño de las páginas fijas: no compatible con la API. Se configura desde el navegador
Autenticación OAuth: solo se admite la autenticación WSSE mediante clave de API
Desarrollo
pnpm run typecheck # 型チェック
pnpm test # ユニットテスト(API はモック)
pnpm run build # dist へビルド
pnpm run dev # ビルドせずに起動
pnpm run inspect # MCP Inspector で手動確認Como pnpm 10 bloquea por defecto los scripts de compilación de las dependencias, solo se permite esbuild, que usa tsx,
mediante pnpm.onlyBuiltDependencies en package.json.
Estructura
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 ツールの共通ヘルパーComo los artículos y las páginas fijas tienen casi la misma estructura en AtomPub, registerCollectionTools de tools/collection.ts
se invoca con dos configuraciones distintas: una para artículos y otra para páginas fijas.
Licencia
MIT License. Consulta LICENSE para más detalles.
Available Tools
13 toolscreate_entryブログ記事作成A
ブログ記事を新規作成する。既定では下書きとして作成されるので、公開する場合は draft を false にする。予約投稿する場合は draft=true・scheduled=true と、未来日時の updated を指定する。
Inputs: title (required), content (required), draft, updated, +5 more.
create_page固定ページ作成A
固定ページを新規作成する。既定では下書きとして作成されるので、公開する場合は draft を false にする。予約投稿する場合は draft=true・scheduled=true と、未来日時の updated を指定する。 固定ページははてなブログの有料プランでのみ利用できる。無料プランでは 404 が返る。
Inputs: title (required), content (required), draft, updated, +4 more.
get_blog_infoブログ情報取得ARead-only
接続先ブログのタイトルと、利用できるコレクション(記事・固定ページ)を取得する。設定と認証が正しいかの疎通確認にも使える。固定ページのコレクションは有料プランでのみ返る。
Inputs: no named parameters.
get_entryブログ記事取得ARead-only
ブログ記事を 1 件取得する。本文(登録記法のまま)・カテゴリ・公開状態を含む。編集前に必ずこれで現状を確認する。
Inputs: entry_id (required), include_formatted_content.
get_page固定ページ取得ARead-only
固定ページを 1 件取得する。本文(登録記法のまま)・カテゴリ・公開状態を含む。編集前に必ずこれで現状を確認する。 固定ページははてなブログの有料プランでのみ利用できる。無料プランでは 404 が返る。
Inputs: page_id (required), include_formatted_content.
list_categoriesカテゴリ一覧ARead-only
ブログで使われているカテゴリの一覧を取得する。記事を作成・更新する前に、既存のカテゴリ名と表記を揃えるために確認する。
Inputs: no named parameters.
list_entriesブログ記事一覧ARead-only
ブログ記事を新しい順に一覧する。下書きも含まれる。1 ページあたりの件数は API 側で決まっており、続きを読むには戻り値の next_page を page に渡す。本文まで読みたい場合は get_entry を使う。
Inputs: page, include_content.
list_pages固定ページ一覧ARead-only
固定ページを新しい順に一覧する。下書きも含まれる。1 ページあたりの件数は API 側で決まっており、続きを読むには戻り値の next_page を page に渡す。本文まで読みたい場合は get_page を使う。 固定ページははてなブログの有料プランでのみ利用できる。無料プランでは 404 が返る。
Inputs: page, include_content.
search_entriesブログ記事検索ARead-only
ブログ記事をページを辿りながら検索する。タイトル・本文・カテゴリを対象に部分一致(大文字小文字は無視)。はてなブログの API は一覧の 1 ページあたり件数が少ないため、まとめて探すときはこのツールを使う。古いブログ記事まで届かない場合は max_pages を増やす。
Inputs: limit, query, status, category, +2 more.
search_pages固定ページ検索ARead-only
固定ページをページを辿りながら検索する。タイトル・本文・カテゴリを対象に部分一致(大文字小文字は無視)。はてなブログの API は一覧の 1 ページあたり件数が少ないため、まとめて探すときはこのツールを使う。古い固定ページまで届かない場合は max_pages を増やす。 固定ページははてなブログの有料プランでのみ利用できる。無料プランでは 404 が返る。
Inputs: limit, query, status, max_pages, +1 more.
update_entryブログ記事更新A
ブログ記事を更新する。指定した項目だけを差し替える差分更新で、省略した項目は現在の値がそのまま残る。下書きを公開するには draft=false を指定する。categories を渡すと現在のカテゴリは完全に置き換わる。
Inputs: entry_id (required), draft, title, content, +5 more.
update_page固定ページ更新A
固定ページを更新する。指定した項目だけを差し替える差分更新で、省略した項目は現在の値がそのまま残る。下書きを公開するには draft=false を指定する。categories を渡すと現在のカテゴリは完全に置き換わる。 固定ページははてなブログの有料プランでのみ利用できる。無料プランでは 404 が返る。
Inputs: page_id (required), draft, title, content, +4 more.
upload_image画像アップロードA
ローカルの画像をはてなフォトライフにアップロードし、記事本文に貼れる記法(embed)を返す。embed は Markdown・はてな記法の編集モード向け。見たままモードのブログでは imageUrl を使う。画像は認証アカウント(HATENA_ID)のフォトライフに保存され、URL を知っていれば誰でも見られる。社外に出してよい画像だけを渡すこと。アップロードした画像の削除はブラウザから行う。
Inputs: file_path (required), title, folder.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Each tool maps to a distinct resource and action: entries, pages, categories, blog info, and image upload are cleanly separated. The list/search/get/create/update split is explicit, and descriptions clarify when to use list versus search.
All tool names use consistent snake_case verb_noun patterns such as list_entries, get_entry, create_page, and update_page. Even the auxiliary tools get_blog_info, list_categories, and upload_image fit the same readable convention.
With 13 tools, the set is well-scoped: entry CRUD/list/search, page CRUD/list/search, plus blog info, categories, and image upload. Each tool has a clear place, and the symmetric entries/pages coverage is reasonable rather than redundant.
The surface covers create, read, update, list, and search for both entries and pages, but deletion operations for entries and pages are missing. Image upload exists without an accompanying delete tool, with deletion explicitly delegated to the browser, leaving lifecycle gaps.
Maintenance
Related MCP Connectors
Travel tools for AI agents: plan and edit real trips, search stays and tours, import travel videos.
Create, edit, organize, publish, and configure JustBlogged blogs from MCP clients.
Web knowledge fetching tools for your agent.
SEO & marketing toolkit for AI agents: GA4, Search Console, AdSense, GTM, PageSpeed, Trends.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables searching and retrieving articles from Hatena Blog through Claude Desktop/Web. Supports keyword search, fetching recent posts, and retrieving post details by URL.1MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with the Google Blogger API v3 to manage blog posts and metadata. It supports the full post lifecycle including creating, updating, publishing, and deleting content through natural language.1020 npm1MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI models to interact with Google Blogger blogs, manage posts, labels, and retrieve blog information via API key or OAuth2.12 npmMIT
- FlicenseNot gradedqualityCmaintenanceEnables AI assistants to publish, update, and manage Hashnode blog articles, with support for tags, cover images, and publication management.-