Beehiiv MCP Server

🚀 Beehiiv MCP 服務器

Beehiiv MCP 服務器是一個模型上下文協議（MCP）服務器，它提供了與 Beehiiv API v2 交互的工具。藉助該服務器，大型語言模型（LLMs）能夠通過標準化工具與 Beehiiv 出版物和帖子進行交互，極大地拓展了信息交互的可能性。

🚀 快速開始

在使用 Beehiiv MCP 服務器之前，需要滿足一些先決條件，並完成相應的安裝和配置步驟。

✅ 先決條件

• Python 3.10 或更高版本
• uv 包管理器
• 帶有 API 訪問權限的 Beehiiv 賬戶
• Claude Desktop（或其他 MCP 兼容客戶端）

📦 安裝指南

以下是詳細的安裝步驟：

1. 如果尚未安裝，請安裝uv：

curl -LsSf https://astral.sh/uv/install.sh | sh

2. 如果從頭開始構建項目，請執行以下操作以創建並設置項目：

# 創建新目錄並進入該目錄
mkdir beehiiv-mcp-server
cd beehiiv-mcp-server

# 創建虛擬環境並激活它
uv venv
source .venv/bin/activate

# 安裝依賴項
uv add "mcp[cli]" httpx python-dotenv

3. 在項目根目錄中創建一個.env文件：

BEEHIIV_API_KEY=your_api_key_here
BEEHIIV_PUBLICATION_ID=your_publication_id_here

🛠️ Claude Desktop 配置

將以下內容添加到 Claude Desktop 配置文件（~/Library/Application Support/Claude/claude_desktop_config.json）中：

{
  "mcpServers": {
    "beehiiv-mcp-server": {
      "command": "<ABSOLUTE_UV_PATH>",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "<ABSOLUTE_SERVER_PATH>"
      ]
    }
  }
}

請替換：

• <ABSOLUTE_UV_PATH> 為您的uv可執行文件的絕對路徑
• <ABSOLUTE_SERVER_PATH> 為您beehiiv_server.py文件的絕對路徑

💻 使用示例

當前，此 MCP 服務器公開了以下實用工具（更多功能即將推出）：

基礎用法

list_publications

列出您 API 密鑰可以訪問的所有出版物。

list_posts

列出指定出版物的 5 條最新確認帖子。

list_posts(publication_id: str)

get_post

獲取特定帖子的詳細信息。

get_post(publication_id: str, post_id: str)

get_post_content

獲取帖子的完整 HTML 內容。

create_new_post

在 Beehiiv 平臺上創建新帖子（僅限企業用戶）。

📚 詳細文檔

工作原理

當您通過 Claude Desktop 與此服務器交互時，會按照以下步驟進行：

1. 客戶端將您的問題發送到 Claude。
2. Claude 分析可用的 Beehiiv 工具並決定使用哪些工具。
3. 客戶端通過此 MCP 服務器執行選定的工具。
4. 結果返回給 Claude。
5. Claude 形成自然語言回覆。
6. 回覆顯示給您。

（即將推出視頻）

常見問題排查

服務器未在 Claude 中顯示

• 檢查您的claude_desktop_config.json文件語法。
• 確保所有路徑均為絕對路徑，而非相對路徑。
• 重新啟動 Claude Desktop。

查看日誌

檢查 Claude 中的 MCP 相關問題日誌：

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

日誌存儲在以下位置：

• ~/Library/Logs/Claude/mcp.log 用於一般的 MCP 連接日誌。
• ~/Library/Logs/Claude/mcp-server-beehiiv-mcp-server.log 用於服務器特定日誌。

⚠️ 重要提示

• 永遠不要在.env文件中公開 API 密鑰等敏感信息。
• 確保服務器運行在安全的網絡環境中。
• 定期更新依賴項以防範潛在的安全漏洞。

🤝 貢獻

如需貢獻或報告問題，請聯繫： [您的聯繫方式]