Alphorn

Alphorn MCP 服务

Alphorn 的 MCP 服务。Alphorn 是一款开源通知路由器。它为 AI Agent（Claude Code、Claude Desktop、Cursor、Codex，以及任何其他 MCP 客户端）提供 send_notification 工具，让 Agent 能通过你在 Alphorn 中配置的任意渠道通知你任务已完成、失败或需要你做出决定；支持 Slack、Telegram、Discord、电子邮件、SMS、推送等。

支持托管服务 app.alphorn.dev 和可自托管的 Alphorn。

设置

1. 在 Alphorn 中创建一个 webhook，并复制其 Endpoint URL；如果你启用了 Require API key，还要复制 API 密钥（文档）。
2. 使用两个环境变量将服务添加到你的 MCP 客户端：

变量	值
ALPHORN_WEBHOOK_URL	Endpoint URL，例如 https://app.alphorn.dev/n/V1StGXR8_Z5jdHi6B-myT
ALPHORN_API_KEY	Webhook API 密钥（alp_...）。如果 webhook 不需要密钥，请不设置此变量。

Claude Code

claude mcp add alphorn -s user \
  -e ALPHORN_WEBHOOK_URL=https://app.alphorn.dev/n/V1StGXR8_Z5jdHi6B-myT \
  -e ALPHORN_API_KEY=alp_... \
  -- npx -y @alphorn/mcp

Claude Desktop（一键安装包）

从最新版本下载 alphorn.mcpb 并打开。Claude Desktop 会提示你输入 Endpoint URL 和 API 密钥。

Claude Desktop、Cursor 和其他使用 JSON 配置的客户端

将以下内容添加到 claude_desktop_config.json、~/.cursor/mcp.json 或客户端的 MCP 配置中：

{
  "mcpServers": {
    "alphorn": {
      "command": "npx",
      "args": ["-y", "@alphorn/mcp"],
      "env": {
        "ALPHORN_WEBHOOK_URL": "https://app.alphorn.dev/n/V1StGXR8_Z5jdHi6B-myT",
        "ALPHORN_API_KEY": "alp_..."
      }
    }
  }
}

OpenAI Codex CLI

# ~/.codex/config.toml
[mcp_servers.alphorn]
command = "npx"
args = ["-y", "@alphorn/mcp"]
env = { ALPHORN_WEBHOOK_URL = "https://app.alphorn.dev/n/V1StGXR8_Z5jdHi6B-myT", ALPHORN_API_KEY = "alp_..." }

工具

send_notification

参数	类型	必填	描述
message	string	是	说明发生了什么，以及 Agent 需要你做什么（最多 4,000 个字符）
title	string	否	简短标题，例如 my-app - tests passing（最多 200 个字符）
priority	integer 1-5	否	2 = 已完成，3 = 需要输入，4 = 受阻或失败，5 = 紧急
tags	string[]	否	用于在 Alphorn 中筛选和路由的标签，例如 ["ai-agent", "completed"]

此工具封装了 Alphorn 的发送端点。若要直接使用 HTTP，请参阅 API 参考和 OpenAPI 3.1 规范。

使用 Alphorn 的筛选器来决定每条通知的发送位置，例如仅在优先级为 4 及以上时发送 SMS。

开发

pnpm install
pnpm test   # builds, then runs the tests against a local fake endpoint

发布

1. 更新 package.json、server.json（两个字段）、manifest.json 和 src/server.ts 中的 VERSION。
2. npm publish --access public
3. 推送 v<version> 标签（或运行 Publish to MCP Registry 工作流）：通过 GitHub OIDC 将 server.json 发布到 MCP Registry
4. 执行 pnpm bundle，然后将 alphorn.mcpb 附加到 GitHub 发行版

许可证

AGPL-3.0-or-later