helloaigent-publisher

Name: helloaigent-publisher
Author: helloaigent-dev

本地服务

github.com/helloaigent-dev商业与营销01 周前更新

代码仓库

关于 helloaigent-publisher

helloaigent-publisher 是用于通过 Agent 管理 Hello Aigent 信息流的 MCP 服务。它支持创建信息流、发布签名更新，并提供订阅者与互动分析，适合运营自有受众的营销人员。

主要功能

01创建和列出信息流
02发布由服务器签名的更新
03报告用户行动结果
04查看信息流与转化漏斗分析
05查看订阅者和事件日志

适用场景

01创建信息流并发布业务动态
02跟踪订阅者和回访率
03在审计日志中查看归因行动

MCP 相关

该 MCP 服务向 Agent 提供 Hello Aigent 信息流管理、发布和分析工具。工作区密钥会将操作范围限制在该工作区拥有的信息流。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "helloaigent-dev-helloaigent-publisher": {
      "command": "npx",
      "args": [
        "-y",
        "@helloaigent-dev/publisher"
      ],
      "env": {
        "HELLOAIGENT_ADMIN_TOKEN": "<HELLOAIGENT_ADMIN_TOKEN>",
        "HELLOAIGENT_TOKEN": "<HELLOAIGENT_TOKEN>",
        "HELLOAIGENT_API": "<HELLOAIGENT_API>"
      }
    }
  }
}

启动命令npx -y @helloaigent-dev/publisher

需要配置的环境变量

HELLOAIGENT_ADMIN_TOKEN密钥Admin token — required for feed management and analytics tools

HELLOAIGENT_TOKEN密钥Publish token (a feed's publisher token); falls back to the admin token

HELLOAIGENT_APIAPI base URL (default https://api.helloaigent.dev)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@helloaigent-dev/publisher0.1.1stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
id	string	否	可选的 feed id slug；若省略，则根据标题自动生成
title	string	是	面向用户的标题，例如 "Acme Roast Drops"
topics	array	否	主题，例如 ["restocks","offers"]
description	string	是	此 Feed 发布的内容
publisher_name	string	是	发布者／品牌名称
publisher_site	string	是	发布者网站 URL

详细介绍

@helloaigent-dev/publisher

Hello Aigent publisher MCP——一个 MCP 服务，让 Agent 运营发布者的信息流：创建信息流、发布签名更新并查看分析数据。它是 @helloaigent-dev/subscriber 的生产者端对应工具（该工具让 Agent 能够订阅、获取并采取行动）。

营销人员只需告诉自己的 Agent，即可运营自有 Agent 受众——无需命令行、控制台或开发人员。

工具

工具	身份验证	功能
`hello_aigent_create_feed`	工作区密钥或管理员	创建信息流、Ed25519 密钥对和发布者令牌；返回发现文件
`hello_aigent_list_feeds`	工作区密钥或管理员	列出你拥有的信息流
`hello_aigent_publish`	发布令牌、工作区密钥或管理员	构建并由服务端签名更新；将其发送给订阅者
`hello_aigent_report_event`	发布令牌、工作区密钥或管理员	报告操作结果（“已采取行动”分析信号）
`hello_aigent_overview`	工作区密钥或管理员	KPI 指标卡、获取趋势线、近期活动
`hello_aigent_funnel`	工作区密钥或管理员	订阅 → 返回 → 采取行动的转化漏斗
`hello_aigent_event_log`	工作区密钥或管理员	可筛选、可归因的审计日志
`hello_aigent_subscribers`	工作区密钥或管理员	自有受众列表（遵循同意设置）
`hello_aigent_discovery_file`	公开	生成要托管在 `/.well-known/` 的 `hello-aigent.json`

“工作区密钥”指 hak_... 工作区 API 密钥——注册后，可在 Hello Aigent 控制台（Feeds → Give your agent access，或 System → API keys）生成。它会将上面所有工具的访问范围限定为你自己的工作区：create_feed 会在你的工作区创建信息流；list_feeds/分析数据/subscribers 只能查看你的工作区拥有的信息流；publish/report_event 也只能用于你的工作区拥有的信息流。它不等同于管理员权限——它不能创建、列出或撤销 API 密钥（这些操作需要登录控制台本身）。

管理员令牌是独立且不受限制、仅供运维使用的凭据（自助注册用户不会获得此令牌）——它仍可像工作区密钥一样用于所有操作，但适用于所有信息流，而不只是你自己的信息流。

配置

在 MCP 客户端配置中设置（环境变量）：

HELLOAIGENT_API — API 基础地址（默认值：https://api.helloaigent.dev）
HELLOAIGENT_API_KEY — 你的工作区 API 密钥（hak_...）；除非使用管理员令牌，否则管理信息流和分析数据时必需。同时设置时，优先使用此变量，而非 HELLOAIGENT_ADMIN_TOKEN。
HELLOAIGENT_ADMIN_TOKEN — 管理员令牌；HELLOAIGENT_API_KEY 的替代选项（仅供运维/内部测试使用）
HELLOAIGENT_TOKEN — 发布令牌（信息流自己的发布者令牌）；若未设置，则依次回退到 HELLOAIGENT_API_KEY 和 HELLOAIGENT_ADMIN_TOKEN

示例（Claude Desktop / 任何 MCP 客户端）——常见情况：自助创建的工作区密钥：

{
  "mcpServers": {
    "hello-aigent-publisher": {
      "command": "npx",
      "args": ["-y", "@helloaigent-dev/publisher"],
      "env": { "HELLOAIGENT_API_KEY": "hak_…" }
    }
  }
}

然后只需向 Agent 提问：“为我的咖啡店创建一个信息流并发布补货更新”，或“本周有多少个 Agent 订阅了？回访率是多少？”

支持 Markdown

登录后评论