AI导哈

Beehiiv新闻通讯管理服务

Beehiiv MCP Server是一个连接Beehiiv新闻通讯平台与Claude Desktop等AI助手的工具，支持通过自然语言添加订阅者、获取文章和管理出版物。

  • by danvega
  • Java
  • 本地部署
  • 21 星标
  • 更新于
在 GitHub 查看 danvega/beehiiv-mcp-server

使用说明

Beehiiv MCP服务器

🚀 超级快速入门：在2分钟内让Beehiyv时事通讯管理在Claude Desktop中工作- 不需要Java！

将您的Beehiiv时事通讯连接到Claude Desktop和其他人工智能助手。使用自然语言添加订阅者、获取帖子和管理出版物。

🎯 选择您的设置方法

方法 时间 要求 最适合
📦 原生二进制 2分钟 没有！ 大多数用户
☕ Java构建 5分钟 Java 24+ 开发人员

你能做什么

设置后，您可以向Claude Desktop询问以下问题：

  • “添加test@example.com我的时事通讯”
  • “显示我最近的5篇时事通讯帖子”
  • 使用自定义字段创建订阅者：姓名John，公司Tech Corp
  • “列出我的所有出版物”

📦 原生二进制（无Java）

非常适合大多数用户 -单文件下载，无需安装！

1.获取您的API证书

  1. 首选 Beehiiv API设置
  2. 复制您的 API密钥 （开始于 bh-)
  3. 复制您的 出版物ID （开始于 pub_)

2.下载二进制文件

选项A：一个命令安装 （Linux/macOS）

curl -fsSL https://raw.githubusercontent.com/danvega/beehiiv-mcp-server/main/scripts/install.sh | bash

选项B：手动下载

首选 最新版本 并下载：

  • Linux: beehiiv-mcp-server-linux
  • macOS: beehiiv-mcp-server-macos
  • 视窗: beehiiv-mcp-server-windows.exe

制作可执行文件（仅限Linux/macOS）：

chmod +x beehiiv-mcp-server-*

3.配置克劳德桌面

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
视窗: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "beehiiv": {
      "command": "/full/path/to/beehiiv-mcp-server-linux",
      "env": {
        "BEEHIIV_API": "bh-your-api-key-here",
        "BEEHIIV_PUBLICATION_ID": "pub-your-publication-id-here"
      }
    }
  }
}

⚠️ 使用完整路径 到您下载的二进制文件。

4.测试它是否有效

  1. 重新启动克劳德桌面
  2. 寻找🔧 新对话中的图标
  3. 尝试： “添加订阅者test@example.com我的时事通讯”

✅ 成功：你应该看到克劳德使用 beehiiv_create_subscription 工具！

☕ Java构建（传统）

对于希望从源代码构建的开发人员

先决条件

步骤

git clone <this-repo>
cd beehiiv-mcp-server
./mvnw clean package -DskipTests

然后配置Claude Desktop：

{
  "mcpServers": {
    "beehiiv": {
      "command": "java",
      "args": [
        "-jar", 
        "/FULL/PATH/TO/target/beehiiv-mcp-server-0.0.3-SNAPSHOT.jar"
      ],
      "env": {
        "BEEHIIV_API": "bh-your-api-key-here",
        "BEEHIIV_PUBLICATION_ID": "pub-your-publication-id-here"
      }
    }
  }
}

🔥 本机映像构建（高级）

对于想要创建优化的本机二进制文件的开发人员

本机映像编译创建了不需要Java运行的快速启动、低内存的可执行文件。

先决条件

  • Java 21+ 使用GraalVM(下载GraalVM)
  • 梅文 （包括通过 ./mvnw)

构建本地映像

git clone <this-repo>
cd beehiiv-mcp-server
./mvnw clean package -Pnative -DskipTests

这将在中创建特定于平台的二进制文件 target/:

  • Linux: beehiiv-mcp-server-linux
  • macOS: beehiiv-mcp-server-macos
  • 视窗: beehiiv-mcp-server-windows.exe

配置Claude桌面

直接使用本机二进制文件，无需Java：

{
  "mcpServers": {
    "beehiiv": {
      "command": "/full/path/to/beehiiv-mcp-server-linux",
      "env": {
        "BEEHIIV_API": "bh-your-api-key-here",
        "BEEHIIV_PUBLICATION_ID": "pub-your-publication-id-here"
      }
    }
  }
}

益处

  • 快速启动：约50ms vs Java的约2s
  • 内存不足：约20MB，而Java约100MB
  • 不需要Java：自包含的可执行文件
  • 更适合生产：优化了运行时性能

先决条件

可用工具

📧 订阅管理

  • 添加订阅者：使用自定义字段创建新订阅
  • 查找订阅者：通过电子邮件或ID查找
  • 自定义字段：向订阅者添加结构化数据

📝 内容管理

  • 获取帖子：获取您发布的时事通讯
  • 单桩：获取特定帖子的详细内容
  • 过滤：按标签、日期、受众类型搜索

🏢 出版管理

  • 列出出版物：查看您的所有时事通讯
  • 出版物详细信息：获取统计数据和设置
  • 多出版物：处理多份时事通讯

示例用法

基本用户

Add john.doe@company.com to my newsletter

具有自定义数据的订阅者

Create a subscription for sarah@startup.com with custom fields: 
name "Sarah Johnson", role "CEO", company "TechStart"

获取最新帖子

Show me my last 10 newsletter posts with their titles and publish dates

UTM跟踪

Add marketing@bigcorp.com with UTM source "website", 
medium "signup", campaign "q4-growth"

高级配置

多种出版物

不要设置 BEEHIIV_PUBLICATION_ID 使用多个时事通讯：

{
  "env": {
    "BEEHIIV_API": "bh-your-api-key-here"
  }
}

然后在请求中指定出版物：

Add user@example.com to publication pub_specific123

HTTP模式（可选）

对于测试或开发，您可以作为web服务器运行：

java -jar target/beehiiv-mcp-server-0.0.2-SNAPSHOT.jar

然后使用： "httpUrl": "http://localhost:8080/mcp" 在Claude桌面配置中。

故障排除

在Claude Desktop中“找不到工具”

  1. 检查JAR路径是否正确和绝对
  2. 验证是否设置了环境变量
  3. 完全重新启动克劳德桌面
  4. 检查Claude Desktop的日志/控制台是否有错误

“无效的API密钥”错误

  1. 验证您的API密钥以 bh-
  2. 检查它是否完全复制（没有多余的空格）
  3. 确保您的Beehiiv帐户已启用API访问

“未找到出版物”

  1. 验证您的发布ID是否以开头 pub_
  2. 检查您是否有权访问此出版物
  3. 尝试不 BEEHIIV_PUBLICATION_ID 并根据请求指定它

启用调试日志记录

设置环境变量： LOGGING_LEVEL_ROOT=DEBUG

手动测试连接

# Test the server directly
curl -X POST http://localhost:8080/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": "1", "method": "tools/list"}'

发展

运行测试

./mvnw test

从源代码构建

./mvnw clean package

项目结构

src/main/java/dev/danvega/beehiiv/
├── Application.java              # Main Spring Boot app
├── core/                        # Configuration & utilities
├── post/                        # Newsletter post management
├── publication/                 # Publication management  
└── subscription/                # Subscriber management

api参考

有关Beehiiv API的详细文档： developers.beehiiv.com

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 添加新功能的测试
  4. 提交拉取请求

支持

相关 MCP