Ghost Admin API

🚀 鬼魂 MCP 服務器

鬼魂 MCP 服務器是一個結合了 Ghost 管理控制檯 API 的 Model Context Protocol (MCP) 服務器。它能讓您通過編程方式訪問 Ghost CMS 的各類功能，如文章管理、頁面管理和成員管理等。

🚀 快速開始

鬼魂 MCP 服務器能幫助您以編程方式與 Ghost CMS 交互。您可以按照以下步驟快速開啟使用。

✨ 主要特性

• 文章管理：支持創建、讀取、更新、刪除和搜索文章。
• 頁面管理：可進行頁面的創建、讀取、更新和刪除操作。
• 標籤管理：方便對文章標籤進行管理。
• 作者管理：有效管理文章作者信息。
• 成員管理：支持成員的創建、讀取、更新、刪除和搜索。
• 圖片上傳支持：允許上傳圖片到系統中。

📦 安裝指南

先決條件

• Node.js（推薦使用 v18 或更高版本）
• Ghost CMS 實例
• Ghost 管理 API 密鑰

安裝步驟

使用 npm 安裝包：

npm install @mtane0412/ghost-mcp-server

📚 詳細文檔

配置

1. 在您的 Ghost 管理控制檯儀表盤中創建一個新的自定義集成，位於設置 > 集成。
2. 設置以下環境變量：

# macOS/Linux
export GHOST_URL="https://your-ghost-blog.com"
export GHOST_ADMIN_API_KEY="your_admin_api_key"

# Windows (PowerShell)
$env:GHOST_URL="https://your-ghost-blog.com"
$env:GHOST_ADMIN_API_KEY="your_admin_api_key"

或者，創建一個 .env 文件：

GHOST_URL=https://your-ghost-blog.com
GHOST_ADMIN_API_KEY=your_admin_api_key

使用

安裝完成後，啟動服務器：

npx @mtane0412/ghost-mcp-server

可用工具

get_posts

獲取文章列表。 輸入：

{
  "limit": "number", // 可選：要獲取的文章數量（1-100，默認值：10）
  "page": "number"   // 可選：頁碼（默認值：1）
}

get_pages

獲取頁面列表。 輸入：

{
  "limit": "number", // 可選：要獲取的頁面數量（1-100，默認值：10）
  "page": "number"   // 可選：頁碼（默認值：1）
}

get_tags

獲取標籤列表。 輸入：

{
  "limit": "number", // 可選：要獲取的標籤數量（1-100，默認值：10）
  "page": "number"   // 可選：頁碼（默認值：1）
}

get_authors

獲取作者列表。 輸入：

{
  "limit": "number", // 可選：要獲取的作者數量（1-100，默認值：10）
  "page": "number"   // 可選：頁碼（默認值：1）
}

get_members

獲取成員列表。 輸入：

{
  "limit": "number", // 可選：要獲取的成員數量（1-100，默認值：10）
  "page": "number"   // 可選：頁碼（默認值：1）
}

upload_image

上傳圖片。 輸入：

{
  "file": "string",   // 必需：Base64 編碼的圖片數據
  "purpose": "string" // 可選：圖片用途（image/profile_image/icon）
}

調試

由於 MCP 服務器通過標準輸入和輸出進行通信，調試可能會比較困難。我們推薦使用 MCP 檢查器，這是一個作為包腳本提供的工具：

npm run inspect

檢查器會在您的瀏覽器中提供一個訪問調試工具的 URL。

📄 許可證

本項目採用 MIT 許可證。