Beehiiv MCP 服务器

一个模型上下文协议 (MCP) 服务器，提供与 Beehiiv API v2 交互的工具。该服务器支持大型语言模型 (LLM) 通过标准化工具与 Beehiiv 出版物和帖子进行交互。

先决条件

• Python 3.10 或更高版本

• uv包管理器

• 具有 API 访问权限的 Beehiiv 帐户

• Claude Desktop（或其他兼容 MCP 的客户端）

Related MCP server: MCP Python Server — API Wrapper

安装

1. 如果尚未安装uv ，请安装：

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

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

# 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

3. 在项目根目录中创建一个.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": "<ABSOLUTE_UV_PATH>",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "<ABSOLUTE_SERVER_PATH>"
      ]
    }
  }
}

代替：

• <ABSOLUTE_UV_PATH>为你的uv可执行文件的路径

• <ABSOLUTE_SERVER_PATH>为beehiiv_server.py文件的绝对路径

可用工具

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

列表出版物

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

列表帖子

列出特定出版物最近确认的 5 篇帖子。

list_posts(publication_id: str)

获取帖子

检索有关特定帖子的详细信息。

get_post(publication_id: str, post_id: str)

获取帖子内容

检索帖子的完整 HTML 内容

创建新帖子

在 beehiiv 平台上创建新帖子（仅限企业）

工作原理

当您通过 Claude Desktop 与此服务器交互时：

1. 客户将您的问题发送给 Claude

2. Claude 分析可用的 Beehiiv 工具并决定使用哪一个

3. 客户端通过此 MCP 服务器执行所选工具

4. 结果被发回给克劳德

5. 克劳德制定了自然语言回应

6. 响应将显示给您

（视频即将发布）

故障排除

Claude 中未显示服务器

1. 检查你的claude_desktop_config.json文件语法

2. 确保所有路径都是绝对路径，而不是相对路径

3. 重启Claude桌面

查看日志

检查 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文件提交到版本控制

• 确保您的 Beehiiv API 密钥安全

• 考虑对 API 调用实施速率限制

贡献

X 上的 hmu ( https://x.com/reymerekar7 )