🚀 Beehiiv MCP 服务器
Beehiiv MCP 服务器是一个模型上下文协议（MCP）服务器，它提供了与 Beehiiv API v2 交互的工具。借助该服务器，大型语言模型（LLMs）能够通过标准化工具与 Beehiiv 出版物和帖子进行交互，极大地拓展了信息交互的可能性。
🚀 快速开始
在使用 Beehiiv MCP 服务器之前，需要满足一些先决条件，并完成相应的安装和配置步骤。
✅ 先决条件
- Python 3.10 或更高版本
uv包管理器- 带有 API 访问权限的 Beehiiv 账户
- Claude Desktop（或其他 MCP 兼容客户端）
📦 安装指南
以下是详细的安装步骤：
- 如果尚未安装，请安装
uv：
curl -LsSf https://astral.sh/uv/install.sh | sh
- 如果从头开始构建项目，请执行以下操作以创建并设置项目：
# 创建新目录并进入该目录
mkdir beehiiv-mcp-server
cd beehiiv-mcp-server
# 创建虚拟环境并激活它
uv venv
source .venv/bin/activate
# 安装依赖项
uv add "mcp[cli]" httpx python-dotenv
- 在项目根目录中创建一个
.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": "" ,
"args": [
"run",
"--with",
"mcp[cli]",
"mcp",
"run",
""
]
}
}
}
请替换：
uv可执行文件的绝对路径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 与此服务器交互时，会按照以下步骤进行：
- 客户端将您的问题发送到 Claude。
- Claude 分析可用的 Beehiiv 工具并决定使用哪些工具。
- 客户端通过此 MCP 服务器执行选定的工具。
- 结果返回给 Claude。
- Claude 形成自然语言回复。
- 回复显示给您。
（即将推出视频）
常见问题排查
服务器未在 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 密钥等敏感信息。 - 确保服务器运行在安全的网络环境中。
- 定期更新依赖项以防范潜在的安全漏洞。
🤝 贡献
如需贡献或报告问题，请联系： [您的联系方式]