Beehiiv MCP Server

Beehiiv MCP服务器

一种模型上下文协议（MCP）服务器，提供与Beehiiv API v2交互的工具。该服务器使大型语言模型（LLM）能够通过标准化工具与Beehiiv的出版物和帖子进行交互。

先决条件

• Python 3.10或更高版本
• uv 包管理器
• 拥有API访问权限的Beehiiv帐户
• Claude Desktop（或其他兼容MCP的客户端）

安装

1. 安装 uv 如果你还没有：

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

1. 如果从头开始重建，请创建并设置您的项目：

# Create a new directory and navigate into it
mkdir beehiiv-mcp-server
cd beehiiv-mcp-server

# Create virtual environment and activate it
uv venv
source .venv/bin/activate

# Install dependencies
uv add "mcp[cli]" httpx python-dotenv

1. 创建一个 .env 项目根目录中的文件：

BEEHIIV_API_KEY=your_api_key_here
BEEHIIV_PUBLICATION_ID=your_publication_id_here

Claude桌面配置

将以下内容添加到您的Claude Desktop配置文件中(~/Library/Application Support/Claude/claude_desktop_config.json):

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

替换：

• ` 通往你的路 uv` 可执行
• ` 与你的绝对路径 beehiiv_server.py` 文件

可用工具

此MCP服务器目前公开了以下工具（将添加更多工具）：

list_出版物

列出使用API密钥可访问的所有出版物。

list_post

列出给定出版物的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. 结果将发送回克劳德
5. 克劳德制定了一个自然语言反应
6. 将向您显示响应

（视频即将发布）

故障排除

服务器未在Claude中显示

1. 检查你的 claude_desktop_config.json 文件语法
2. 确保所有路径都是绝对的，而不是相对的
3. 重新启动克劳德桌面

查看日志

检查克劳德的日志，了解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 文件到版本控制
• 确保Beehiiv API密钥的安全
• 考虑为API调用实现速率限制

贡献

hmu on X(https://x.com/reymerekar7)