Beehiiv MCP 服务器

Name: Beehiiv MCP Server
Author: reymerekar7

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

先决条件

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

Related MCP server: Couchbase MCP Server for LLMs

安装

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

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

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

# 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

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 与此服务器交互时：

客户将您的问题发送给 Claude
Claude 分析可用的 Beehiiv 工具并决定使用哪一个
客户端通过此 MCP 服务器执行所选工具
结果被发回给克劳德
克劳德制定了自然语言回应
响应将显示给您

（视频即将发布）

故障排除

Claude 中未显示服务器

检查你的claude_desktop_config.json文件语法
确保所有路径都是绝对路径，而不是相对路径
重启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 )

Install Server

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Beehiiv MCP Server