Ghost MCP

🚀 鬼魂 MCP 服務器

一個用於通過大型語言模型 (LLM) 接口與 Ghost CMS 交互的 Model Context Protocol (MCP) 服務器。此服務器提供安全且全面的 Ghost 博客訪問權限，並利用 JWT 認證和豐富的 MCP 工具集，支持管理文章、用戶、成員、訂閱層級、優惠和簡報。

🚀 快速開始

要與此 MCP 服務器配合使用，請在 claude_desktop.yaml 中添加以下內容：

ghost-mcp-server:
  enabled: true
  endpoint: http://localhost:5000

默認端口為 5000。請參考 配置文件 瞭解詳細信息。

✨ 主要特性

• 使用 @tryghost/admin-api 安全請求 Ghost Admin API
• 全面的實體訪問權限，涵蓋文章、用戶、成員、訂閱層級、優惠和簡報
• 高級搜索功能，支持模糊匹配和精確匹配選項
• 詳細且易於理解的實體輸出
• 使用自定義 GhostError 異常處理錯誤
• 集成的日誌記錄支持（通過 MCP 上下文），便於故障排除

📦 安裝指南

我完全使用 TypeScript 重寫了 Ghost MCP Server，並在 v0.1.0 版本中發佈。此次重大變更帶來了以下好處：

• 安裝簡化：現在以 NPM 包形式提供（@fanyangmeng/ghost-mcp）
• 可靠性提升：使用官方 @tryghost/admin-api 客戶端，而非自定義實現
• 維護更簡便：TypeScript 提供類型安全和更好的代碼組織
• 配置更簡潔：僅需設置 Node.js 環境變量

重大更改

• Python 依賴不再需要
• 配置方法發生變化（現使用 Node.js 環境變量）
• Docker 部署簡化
• 安裝流程變更（現使用 NPM）

請參閱下方更新文檔，瞭解如何從 Python 版本遷移。如果遇到問題，請在 GitHub 上提交 issue。

環境變量

以下是運行服務器所需的環境變量：

• GHOST_ADMIN_URL: Ghost 行政界面 URL（必需）
• GHOST_ADMIN_KEY: Ghost 行政 API 密鑰（必需）
• PORT：服務器監聽的端口，默認為 5000
• NODE_ENV：環境模式，生產或開發

💻 使用示例

基礎用法

要與此 MCP 服務器配合使用，請在 claude_desktop.yaml 中添加以下內容：

ghost-mcp-server:
  enabled: true
  endpoint: http://localhost:5000

高級用法

以下展示了文章管理和用戶管理的代碼示例：

文章管理

interface GhostArticleToolParams {
  title: string;
  content: string;
  authorId?: string;
  publishedAt?: string;
}

async function createGhostArticle(params: GhostArticleToolParams): Promise<void> {
  // 創建文章邏輯
}

async function updateGhostArticle(articleId: string, params: Omit<GhostArticleToolParams, 'title'>): Promise<void> {
  // 更新文章邏輯
}

async function deleteGhostArticle(articleId: string): Promise<void> {
  // 刪除文章邏輯
}

用戶管理

interface GhostUserToolParams {
  email: string;
  password: string;
  username?: string;
}

async function createUser(params: GhostUserToolParams): Promise<string> {
  // 創建用戶邏輯，返回用戶 ID
}

async function updateUser(userId: string, params: Omit<GhostUserToolParams, 'email'>): Promise<void> {
  // 更新用戶邏輯
}

🔧 技術細節

Ghost MCP Server 使用自定義的 GhostError 異常來處理 API 通信錯誤和處理問題，以確保清晰且詳細的錯誤消息，便於故障排除。

🤝 貢獻指南

1. 叉倉庫
2. 創建功能分支
3. 提交更改
4. 創建拉取請求

📄 許可證

MIT