JinDaGe - beehiiv-mcp-server MCP Details

article

README

🚀 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

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 与此服务器交互时，会按照以下步骤进行：

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

🤝 贡献

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

beehiiv-mcp-server