Beehiiv MCP Server

Beehiiv MCP 服务

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

前提条件

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

安装

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 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 中未显示服务

1. 检查 claude_desktop_config.json 文件的语法
2. 确保所有路径都是绝对路径，而不是相对路径
3. 重启 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 文件提交到版本控制系统
• 妥善保管 Beehiiv API 密钥
• 考虑为 API 调用实施速率限制

贡献

在 X 上联系我（https://x.com/reymerekar7）