Alphorn

Alphorn MCP サーバー

オープンソースの通知ルーターである Alphorn 用の MCP サーバーです。AI エージェント（Claude Code、Claude Desktop、Cursor、Codex、その他の MCP クライアント）に send_notification ツールを提供し、タスクが完了したとき、失敗したとき、または判断が必要なときに、Alphorn で設定した任意のチャンネル（Slack、Telegram、Discord、メール、SMS、プッシュ通知など）を通じてエージェントから通知を受け取れます。

app.alphorn.dev のホステッドサービスと、セルフホスト版の Alphorn の両方で動作します。

セットアップ

1. Alphorn でウェブフックを作成し、Endpoint URL をコピーします。Require API key を有効にした場合は、API キーもコピーしてください（ドキュメント）。
2. 次の 2 つの環境変数を使って、MCP クライアントにサーバーを追加します。

変数	値
ALPHORN_WEBHOOK_URL	Endpoint URL。例：https://app.alphorn.dev/n/V1StGXR8_Z5jdHi6B-myT
ALPHORN_API_KEY	ウェブフックの API キー（alp_...）。ウェブフックで API キーが不要な場合は設定しないでください。

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	はい	何が起きたのか、エージェントがあなたに何を求めているのか（最大 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 の 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