Jekyll MCP Server

🚀 Jekyll MCP Server

Jekyll MCP Server 是一個基於 模型上下文協議（Model Context Protocol，MCP） 的服務器，它可以對 Jekyll 博客內容進行索引和搜索，使 Claude 等 AI 助手能夠與你的博客文章進行交互。

✨ 主要特性

• 對 Jekyll 博客文章和草稿進行索引，並解析前置元數據（front matter）。
• 支持按關鍵詞、類別或標籤搜索文章。
• 可通過文章的 slug（唯一標識符）檢索完整的文章內容。
• 對比草稿內容與已發佈文章，檢測重複內容。
• 列出所有類別和標籤，並顯示對應的文章數量。
• 支持 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 博客內容的存儲位置，有兩種配置方式：

方式一：使用環境變量

在啟動服務器之前，設置以下環境變量：

export JEKYLL_POSTS_DIR="/path/to/your/blog/_posts"
export JEKYLL_DRAFTS_DIR="/path/to/your/blog/_drafts"  # 可選

方式二：從 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（字符串，可選）：在文章標題、內容或 slug 中搜索的關鍵詞。
• category（字符串，可選）：按類別過濾。
• tags（字符串，可選）：以逗號分隔的標籤列表。
• limit（數字，可選）：最大返回結果數（默認值：10）。 示例：

Search for posts about "AI writing" in the "blog" category

get_post

通過文章的 slug 檢索完整的文章內容。 參數：

• slug（字符串，必需）：文章的 slug。 示例：

Get the post with slug "working-with-the-machine"

list_categories

列出所有博客類別，並顯示對應的文章數量。 示例：

Show me all categories

list_tags

列出所有博客標籤，並顯示對應的文章數量。 示例：

What tags do I use?

compare_draft

對比草稿內容與已發佈文章，查找相似內容（有助於避免發佈重複文章）。 參數：

• draft_content（字符串，必需）：要對比的草稿文本。
• limit（數字，可選）：最大返回的相似文章數（默認值：5）。 示例：

Compare this draft against my published posts:
[paste draft content]

示例工作流程

以下是如何在 Claude Code 中使用該服務器的示例：

1. 撰寫新文章之前：

Search my posts for "AI writing process"

2. 檢查是否已涵蓋某個主題：

Have I written about MCP servers before?

3. 避免重複內容：

Compare this draft against my published posts:
[paste draft]

4. 檢索現有內容：

Get the full content of my post "working-with-the-machine"

5. 分析博客：

What categories do I write about most?

重新索引內容

服務器在啟動時會對內容進行索引。在發佈新文章或進行重大更改後，需要重新索引內容：

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 文件。

貢獻說明

歡迎貢獻代碼！請隨時提交 Pull Request。

致謝

本項目基於 Anthropic 開發的 模型上下文協議 構建。

本 README 在 Claude Code 的協助下完成。