Jekyll MCP Server

🚀 Jekyll MCP Server

Jekyll MCP Serverは、Model Context Protocol (MCP)に基づくサーバーです。Jekyllブログのコンテンツをインデックス化し、検索することができ、ClaudeなどのAIアシスタントがブログ記事と対話できるようにします。

✨ 主な機能

• フロントマターを解析して、Jekyllのブログ記事と下書きをインデックス化する
• キーワード、カテゴリ、またはタグで記事を検索する
• スラッグで完全な記事内容を取得する
• 下書き内容を公開済みの記事と比較して、重複を検出する
• 記事数を含めたすべてのカテゴリとタグを一覧表示する
• Markdown (.md) とAsciiDoc (.adoc) の両方の形式をサポートする
• 高速なキーワードベースの検索

📦 インストール

uvを使用する（推奨）

uv pip install jekyll-mcp-server

pipを使用する

pip install jekyll-mcp-server

ソースからインストールする

git clone https://github.com/jottinger/jekyll-mcp-server.git
cd jekyll-mcp-server
uv pip install -e .

設定

サーバーには、Jekyllブログのコンテンツがどこにあるかを知らせる必要があります。これを設定する方法は2つあります。

オプション1: 環境変数

サーバーを起動する前に、これらの環境変数を設定します。

export JEKYLL_POSTS_DIR="/path/to/your/blog/_posts"
export JEKYLL_DRAFTS_DIR="/path/to/your/blog/_drafts"  # オプション

オプション2: Jekyllプロジェクトディレクトリから実行する

サーバーをJekyllプロジェクトのルート（_posts と _drafts ディレクトリが存在する場所）から実行すると、自動的に検出されます。

💻 使用例

Claude Codeでの使用

Claude CodeのMCP設定に追加します。

{
  "mcpServers": {
    "jekyll-blog": {
      "command": "jekyll-mcp-server",
      "env": {
        "JEKYLL_POSTS_DIR": "/path/to/your/blog/_posts",
        "JEKYLL_DRAFTS_DIR": "/path/to/your/blog/_drafts"
      }
    }
  }
}

その後、Claude Codeを再起動します。サーバーは必要に応じて自動的に起動します。

手動起動

起動スクリプトを作成します（examples/launch-server.sh を参照）。

#!/bin/bash
export JEKYLL_POSTS_DIR="/path/to/your/blog/_posts"
export JEKYLL_DRAFTS_DIR="/path/to/your/blog/_drafts"
jekyll-mcp-server

実行可能にしてから実行します。

chmod +x launch-server.sh
./launch-server.sh

利用可能なMCPツール

接続すると、サーバーはAIアシスタントにこれらのツールを提供します。

search_posts

キーワード、カテゴリ、またはタグでブログ記事を検索します。

パラメータ:

• query (文字列、オプション): タイトル、内容、またはスラッグで検索する用語
• category (文字列、オプション): カテゴリでフィルタリングする
• tags (文字列、オプション): カンマ区切りのタグのリスト
• limit (数値、オプション): 最大結果数（デフォルト: 10）

例:

「AI writing」に関する記事を「blog」カテゴリから検索する

get_post

スラッグで特定の記事の完全な内容を取得します。

パラメータ:

• slug (文字列、必須): 記事のスラッグ

例:

スラッグが「working-with-the-machine」の記事を取得する

list_categories

記事数を含めたすべてのブログカテゴリを一覧表示します。

例:

すべてのカテゴリを表示する

list_tags

記事数を含めたすべてのブログタグを一覧表示します。

例:

私が使用しているタグは何ですか？

compare_draft

下書き内容を公開済みの記事と比較して、類似する内容を見つけます（重複記事を回避するのに役立ちます）。

パラメータ:

• draft_content (文字列、必須): 比較する下書きテキスト
• limit (数値、オプション): 返す最大類似記事数（デフォルト: 5）

例:

この下書きを私の公開済み記事と比較する:
[下書き内容を貼り付ける]

例のワークフロー

Claude Codeでこれを使用する方法は次のとおりです。

1. 新しい記事を書く前に:

   「AI writing process」に関する記事を検索する
   

2. トピックをカバーしたかどうかを確認する:

   私は以前にMCPサーバーについて書いたことがありますか？
   

3. 重複コンテンツを防止する:

   この下書きを私の公開済み記事と比較する:
   [下書きを貼り付ける]
   

4. 既存のコンテンツを取得する:

   私の記事「working-with-the-machine」の完全な内容を取得する
   

5. ブログを分析する:

   私が最も多く書いているカテゴリは何ですか？
   

コンテンツの再インデックス化

サーバーは起動時にコンテンツをインデックス化します。新しい記事を公開したり、大幅な変更を加えた後は、次の手順を実行します。

1. サーバーを停止します（スタンドアロンで実行している場合）
2. インデックスを更新するために再起動します

Claude Codeでは、サーバーは必要に応じて自動的に再起動します。

開発

セットアップ

git clone https://github.com/jottinger/jekyll-mcp-server.git
cd jekyll-mcp-server
uv venv
source .venv/bin/activate  # Windowsの場合: .venv\Scripts\activate
uv pip install -e ".[dev]"

テストの実行

pytest

プロジェクト構造

jekyll-mcp-server/
├── jekyll_mcp/
│   ├── __init__.py
│   ├── server.py       # MCPサーバーの実装
│   ├── indexer.py      # 記事のインデックス化ロジック
│   ├── parser.py       # フロントマターの解析
│   └── tools.py        # MCPツールの実装
├── examples/
│   ├── claude-code-config.json
│   └── launch-server.sh
├── tests/
├── LICENSE
├── README.md
└── pyproject.toml

要件

• Python 3.10以上
• 標準の _posts ディレクトリ構造を持つJekyllブログ
• YAMLフロントマターを持つ記事

📄 ライセンス

MITライセンス - 詳細については LICENSE ファイルを参照してください。

コントリビューション

コントリビューションを歓迎します！プルリクエストを送信してください。

謝辞

このプロジェクトは、Anthropicによる Model Context Protocol を使用して構築されています。 Claude Codeの支援を受けて作成されました。