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 的协助下完成。