AI导哈

Beehiiv API交互工具

一个Model Context Protocol (MCP)服务器，提供与Beehiiv API v2交互的工具，使大型语言模型(LLMs)能够通过标准化工具与Beehiiv出版物和帖子进行交互。

  • by reymerekar7
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 reymerekar7/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": "<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_出版物

列出使用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)

相关 MCP