公開サイト: https://hermes.ai-deck.app
Hermes Desktopの導入、基本操作、設定、安全な運用、問題解決を日本語でまとめた非公式ドキュメントサイト。Obsidian Vaultを正本に、Astro Starlightで静的サイト化する。
- Pagefindによる本文・見出し・タグの全文検索
- モバイル対応のサイドバー、目次、ダークモード
- キーボード操作と支援技術に配慮したStarlight標準UI
- frontmatter
slugによるフォルダ構成と独立した恒久URL - Obsidian WikiLinkとコールアウトの自動変換
- basename、slug、未解決リンクをビルド前に検出
- 「実機・内容確認日」「対応バージョン／コミット」の表示
- Astro 6
- Astro Starlight
- Pagefind
- TypeScript
- Biome
- Cloudflare Workers（Static Assets / Workers Builds）
本番サイトはhttps://hermes.ai-deck.appで公開中。mainへpushするとWorkers Builds（GitHub連携）が自動でビルド・デプロイする。
- Node.js >= 22.12.0
npm install記事の正本はリポジトリ内のvault/にある。ObsidianでこのフォルダをVaultとして開けば、サイトと同じリポジトリでコンテンツを編集できる。
| コマンド | 内容 |
|---|---|
npm run dev |
開発サーバーを起動 |
npm run build |
本番ビルドとPagefindインデックス生成 |
npm run preview |
ビルド結果をローカルプレビュー |
npm run preprocess |
Vaultを検証してsrc/content/docs/へ変換 |
npm run validate:content |
コンテンツ変換と前処理テスト |
npm run lint |
Biomeチェック |
npm run check |
Astro型チェック |
npm test |
前処理の自動テスト |
npm run check:links |
ビルド済み内部リンク・アンカーを検査 |
npm run quality |
Lint、型、テスト、ビルド、リンク検査を一括実行 |
vault/ Obsidian Vault、コンテンツの正本
↓ npm run preprocess
scripts/preprocess.ts frontmatter・slug・WikiLink・コールアウトを検証変換
↓
src/content/docs/ 生成物、gitignore対象
↓
Astro Starlight ルーティング、ナビ、目次、検索、SEO
↓
dist/ 静的サイトとPagefindインデックス
src/content/docs/は毎回全削除して再生成するため、直接編集しない。
00_ホーム.md
01_はじめに/
02_基本操作/
03_設定/
04_ガイド/
05_トラブルシューティング/
06_リファレンス/
07_ダッシュボード/
08_連携/
フォルダとファイルの数字はObsidian内の並び順にだけ使う。公開URLはfrontmatter slugから生成する。
03_設定/12_MCP.md → /settings/mcp/
04_ガイド/01_推奨設定プリセット.md → /guides/recommended-presets/
---
title: MCP
description: Hermes DesktopでMCPサーバーを設定する方法と安全上の注意。
slug: settings/mcp
sidebar:
order: 12
tags: [hermes, settings, mcp]
audience: [Hermes Desktop利用者]
platforms: [macOS, Windows, Linux]
status: verified
hermes_version: "0.17.0"
hermes_commit: "857d024"
verified: 2026-06-20
---title、description、slugは必須slugはASCII小文字、数字、ハイフン、/だけを使うdraft: trueのページは本番ビルドから除外されるstatusはverifiedまたはneeds-review- 内容のない準備中ページは公開しない
パス付きWikiLinkを基本とする。
[[03_設定/12_MCP|MCP]]
[[03_設定/08_詳細#実行バックエンド|隔離バックエンド]]basenameだけのリンクはVault全体でファイル名が一意な場合のみ解決できる。basename重複、slug重複、未解決リンクは前処理を失敗させる。
Obsidian記法をStarlight Asideへ変換する。
> [!warning] 注意
> 実行内容を確認してください。対応type:
note/info/importantwarning/cautiondanger/errortip
旧番号付きURLはastro.config.mjsで恒久URLへリダイレクトする。本番ドメインhttps://hermes.ai-deck.appをsiteに設定済みで、canonical、OGP絶対URL、sitemap（/sitemap-index.xml）が有効。public/robots.txtがsitemapを参照する。
Cloudflare Workers（Static Assets）にWorkers Builds（GitHub連携）でデプロイする。mainへpushすると本番デプロイ、非本番ブランチはnpx wrangler versions uploadでプレビューが作られる。公開URLはカスタムドメインhttps://hermes.ai-deck.app。ローカルから手動デプロイする場合はnpm run deploy（astro build && wrangler deploy）。
誤りの指摘・修正を歓迎する。
- 気軽な報告: Issue または X（@nagataku_ai）
- 直接修正: Pull Request。編集対象は
vault/配下のみ（src/content/docs/は自動生成の中間生成物のため編集しない） - 設定値・既定値の変更報告には、確認したアプリのバージョン（設定 > 情報）を添えてもらえると検証が速い
- PR前に
npm run qualityを実行すると、リンク切れやfrontmatter不備を事前に検出できる
このリポジトリは内容の種類ごとに異なる扱いを併用する。適用範囲と除外の正本はLICENSING.md。
- 技術ドキュメント（
vault/配下の解説本文と図版）: CC BY 4.0（クリエイティブ・コモンズ 表示 4.0 国際） - ソースコード（
scripts/、src/、設定ファイル）: MIT License - 著者・ブランド・集客に関する素材（著者/サービス紹介、ロゴ・サイト名等のブランド要素、広告・アフィリエイト関連の記述）: 権利留保（All Rights Reserved。CC BY 4.0 の対象外）
「権利留保」は3つ目のライセンスではなく、ライセンスを付与しない既定の状態を指す。詳細はLICENSING.mdを参照。
© 2026 Taku Nagai（ながたく）
Hermes DesktopはNous Researchの製品であり、本リポジトリはコミュニティによる非公式の日本語ガイドである。最新かつ正確な情報は公式ドキュメントを参照すること。