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 密钥等敏感信息。
• 确保服务器运行在安全的网络环境中。
• 定期更新依赖项以防范潜在的安全漏洞。

🤝 贡献

如需贡献或报告问题，请联系： [您的联系方式]