STARWARCLOUD STARWAR.AI
返回市场
蜂巢-MCP服务器

蜂巢-MCP服务器

作者：danvega13 星标更新：2025-06-25
安装使用来源：spider==github.com

项目介绍

Beehiiv MCP Server

🚀 超级快速启动：在不到2分钟内让Beehiiv新闻通讯管理在Claude Desktop上运行——无需Java！

将您的Beehiiv新闻通讯连接到Claude Desktop和其他AI助手。使用自然语言添加订阅者、获取帖子并管理发布。

🎯 选择您的设置方法

方法时间要求最适合
📦 原生二进制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
  • Windows：beehiiv-mcp-server-windows.exe

使可执行（仅限Linux/macOS）：

chmod +x beehiiv-mcp-server-*

3. 配置Claude Desktop

macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%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. 重启Claude Desktop
  2. 查找新对话中的🔧图标
  3. 尝试："将订阅者test@example.com添加到我的新闻通讯中"

✅ 成功：您应该看到Claude使用了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)
  • Maven（通过./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
  • Windows：beehiiv-mcp-server-windows.exe

配置Claude Desktop

直接使用原生二进制文件，无需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"
      }
    }
  }
}

优点

  • 快速启动：约50毫秒 vs Java的约2秒
  • 低内存消耗：约20MB vs Java的约100MB
  • 无需Java：独立可执行文件
  • 更适合生产环境：优化的运行时性能

先决条件

可用工具

📧 订阅者管理

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

📝 内容管理

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

🏢 发布管理

  • 列出发布：查看所有新闻通讯
  • 发布详情：获取统计信息和设置
  • 多发布：处理多个新闻通讯

示例用法

基本订阅者

将john.doe@company.com添加到我的新闻通讯中

带有自定义数据的订阅者

为sarah@startup.com创建一个订阅，并带有自定义字段： 
姓名 "Sarah Johnson"，角色 "CEO"，公司 "TechStart"

获取最近的帖子

显示我最后10篇新闻通讯帖子及其标题和发布时间

UTM跟踪

添加marketing@bigcorp.com，并带有UTM来源 "网站"， 
媒介 "注册"，活动 "Q4增长"

高级配置

多个发布

不设置BEEHIIV_PUBLICATION_ID以处理多个新闻通讯：

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

然后在请求中指定发布：

将user@example.com添加到发布pub_specific123

HTTP模式（替代方案）

为了测试或开发，您可以作为Web服务器运行：

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

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

故障排除

"工具未找到"在Claude Desktop中

  1. 检查JAR路径是否正确且为绝对路径
  2. 验证环境变量是否设置
  3. 完全重启Claude Desktop
  4. 检查Claude Desktop的日志/控制台是否有错误

"无效API密钥"错误

  1. 验证您的API密钥是否以bh-开头
  2. 检查是否完全复制（没有额外空格）
  3. 确保您的Beehiiv账户启用了API访问

"发布未找到"

  1. 验证您的发布ID是否以pub_开头
  2. 检查您是否有此发布的访问权限
  3. 尝试不设置BEEHIIV_PUBLICATION_ID并在每个请求中指定它

启用调试日志记录

设置环境变量：LOGGING_LEVEL_ROOT=DEBUG

手动测试连接

# 直接测试服务器
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              # 主Spring Boot应用
├── core/                        # 配置及实用工具
├── post/                        # 新闻通讯帖子管理
├── publication/                 # 发布管理  
└── subscription/                # 订阅者管理

API参考

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

贡献

  1. 分叉仓库
  2. 创建功能分支
  3. 为新功能添加测试
  4. 提交拉取请求

支持