B

Beehiiv MCP服务器

@reymerekar7/beehiiv-mcp-server
0 Stars 7 次浏览 reymerekar7 更新于 2026-08-23

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

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

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

该服务需要配置环境变量：BEEHIIV_API_KEY、BEEHIIV_PUBLICATION_ID

服务介绍

image

Beehiiv MCP 服务器

这是一个提供与Beehiiv API v2交互工具的模型上下文协议（MCP）服务器。该服务器使大型语言模型（LLMs）能够通过标准化工具与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 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)

工作原理

当您通过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)

查看源码 项目主页