Ermöglicht es AI Agents, Benachrichtigungen über Slack, Telegram, E-Mail, SMS oder Push via eines Alphorn webhooks zu versenden.
Auch bekannt als alphorn-dev/mcp, mcp, @alphorn/mcp
- Stars
- 0
- Tools
- 4
- Downloads, 30 Tage
- 608
- Neueste Version
- 0.1.1
- Letzter Commit
- 12. Okt. 2026
- Lizenz
- AGPL-3.0
Was ist Alphorn MCP?
Ermöglicht es AI Agents, Benachrichtigungen über Slack, Telegram, E-Mail, SMS oder Push via eines Alphorn webhooks zu versenden. Er stellt 4 Tools bereit, etwa message, title, priority.
Zusammenfassung generiert aus dem README des Projekts
Über Alphorn MCP server
Alphorn bietet AI Agents eine Möglichkeit, über verschiedene Messaging-Kanäle mit Nutzern zu kommunizieren. Durch die Nutzung des send_notification Tools können Agents, die in Clients wie Claude Desktop, Cursor oder Claude Code integriert sind, Alerts an Slack, Telegram, Discord, E-Mail, SMS oder Push-Benachrichtigungen senden. Dieser MCP server fungiert als Bridge zum Alphorn Notification Router, der entweder über den Hosted Service unter app.alphorn.dev oder durch eine Self-Hosted Installation genutzt werden kann.
Um den Server einzurichten, müssen Entwickler eine ALPHORN_WEBHOOK_URL und optional einen ALPHORN_API_KEY als Umgebungsvariablen angeben. Das Tool erlaubt detaillierte Nachrichten, inklusive Titel, einem Nachrichtentext von bis zu 4.000 Zeichen, einer Prioritätsstufe von 1 bis 5 und benutzerdefinierten Tags. Diese Parameter ermöglichen es Nutzern, spezifische Alerts, wie etwa dringende Fehler, mithilfe von Alphorn-Filtern an verschiedene Kanäle zu routen.
Was du damit machen kannst
- 1Benachrichtigung bei Task-AbschlussBitte den Agenten, eine Nachricht an deinen bevorzugten Kanal zu senden, sobald eine lang laufende Coding-Aufgabe abgeschlossen ist.
- 2Alert bei kritischen FehlernWeise die KI an, eine dringende Benachrichtigung zu senden, falls ein Prozess blockiert oder auf einen Fehler stößt.
- 3Menschliche Intervention anfordernLass den Agenten eine Benachrichtigung auslösen, wenn er einen Punkt erreicht, an dem eine Entscheidung durch einen Nutzer erforderlich ist.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du Alphorn MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenAlphorn MCP in Claude Code installieren
$ claude mcp add --env 'ALPHORN_WEBHOOK_URL=<YOUR_ALPHORN_WEBHOOK_URL>' --env 'ALPHORN_API_KEY=<YOUR_ALPHORN_API_KEY>' mcp -- npx -y @alphorn/mcpAlphorn MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@alphorn/mcp"
],
"env": {
"ALPHORN_WEBHOOK_URL": "<YOUR_ALPHORN_WEBHOOK_URL>",
"ALPHORN_API_KEY": "<YOUR_ALPHORN_API_KEY>"
}
}
}
}Alphorn MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@alphorn/mcp"
],
"env": {
"ALPHORN_WEBHOOK_URL": "<YOUR_ALPHORN_WEBHOOK_URL>",
"ALPHORN_API_KEY": "<YOUR_ALPHORN_API_KEY>"
}
}
}
}Alphorn MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@alphorn/mcp"],"env":{"ALPHORN_WEBHOOK_URL":"<YOUR_ALPHORN_WEBHOOK_URL>","ALPHORN_API_KEY":"<YOUR_ALPHORN_API_KEY>"}}'Alphorn MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@alphorn/mcp"
],
"env": {
"ALPHORN_WEBHOOK_URL": "<YOUR_ALPHORN_WEBHOOK_URL>",
"ALPHORN_API_KEY": "<YOUR_ALPHORN_API_KEY>"
}
}
}
}Alphorn MCP in Codex installieren
$ codex mcp add mcp --env 'ALPHORN_WEBHOOK_URL=<YOUR_ALPHORN_WEBHOOK_URL>' --env 'ALPHORN_API_KEY=<YOUR_ALPHORN_API_KEY>' -- npx -y @alphorn/mcpAlphorn MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@alphorn/mcp"] [mcp_servers.mcp.env] ALPHORN_WEBHOOK_URL = "<YOUR_ALPHORN_WEBHOOK_URL>" ALPHORN_API_KEY = "<YOUR_ALPHORN_API_KEY>"
Alphorn MCP in Gemini CLI installieren
$ gemini mcp add -s user -e 'ALPHORN_WEBHOOK_URL=<YOUR_ALPHORN_WEBHOOK_URL>' -e 'ALPHORN_API_KEY=<YOUR_ALPHORN_API_KEY>' mcp npx -- -y @alphorn/mcpAlphorn MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@alphorn/mcp"
],
"env": {
"ALPHORN_WEBHOOK_URL": "<YOUR_ALPHORN_WEBHOOK_URL>",
"ALPHORN_API_KEY": "<YOUR_ALPHORN_API_KEY>"
}
}
}
}Alphorn MCP tools 4
Erkannt aus dem READMEmessagetitleprioritytags
| message | — | |
| title | — | |
| priority | — | |
| tags | — |
Konfiguration
ALPHORN_WEBHOOK_URLErforderlichSecretWebhook Endpoint URL, e.g. https://app.alphorn.dev/n/V1StGXR8_Z5jdHi6B-myT
ALPHORN_API_KEYSecretWebhook API key (alp_...), if the webhook requires one
| Name | Beschreibung | Typ |
|---|---|---|
| ALPHORN_WEBHOOK_URL | Webhook Endpoint URL, e.g. https://app.alphorn.dev/n/V1StGXR8_Z5jdHi6B-myT | ErforderlichSecret |
| ALPHORN_API_KEY | Webhook API key (alp_...), if the webhook requires one | Secret |
Automatisierte Checks
Geluften am 13. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarBestanden
- Open Source Lizenz (OSI)Bestanden
- Commit oder Release im letzten JahrBestanden
- Package-Name ähnelt keinem populären PackageBestanden
- Remote Endpoint nutzt HTTPSNicht geprüft
- Destruktive Tools sind markiertBestanden
- Keine versteckten Anweisungen an das ModellBestanden
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenBestanden
README
Auf GitHub ansehenAlphorn MCP Server
MCP server for Alphorn, the open-source notification router. It gives AI agents (Claude Code, Claude Desktop, Cursor, Codex, and any other MCP client) a send_notification tool, so an agent can tell you when a task finishes, fails, or needs your decision, on whatever channel you configured in Alphorn: Slack, Telegram, Discord, email, SMS, push, and more.
Works with the hosted service at app.alphorn.dev and with self-hosted Alphorn.
Setup
- Create a webhook in Alphorn and copy its Endpoint URL, plus its API key if you switched on Require API key (docs).
- Add the server to your MCP client with two environment variables:
| Variable | Value |
|---|---|
ALPHORN_WEBHOOK_URL |
Endpoint URL, e.g. https://app.alphorn.dev/n/V1StGXR8_Z5jdHi6B-myT |
ALPHORN_API_KEY |
Webhook API key (alp_...). Leave unset if the webhook does not require one. |
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 (one-click bundle)
Download alphorn.mcpb from the latest release and open it. Claude Desktop asks for the Endpoint URL and API key.
Claude Desktop, Cursor, and other JSON-configured clients
Add to claude_desktop_config.json, ~/.cursor/mcp.json, or your client's MCP config:
{
"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_..." }
Tool
send_notification
| Argument | Type | Required | Description |
|---|---|---|---|
message |
string | yes | What happened and what the agent needs from you (max 4,000 characters) |
title |
string | no | Short title, e.g. my-app - tests passing (max 200 characters) |
priority |
integer 1-5 | no | 2 = finished, 3 = needs input, 4 = blocked or failed, 5 = urgent |
tags |
string[] | no | Tags to filter and route on in Alphorn, e.g. ["ai-agent", "completed"] |
The tool wraps Alphorn's send endpoint. For direct HTTP use, see the API reference and the OpenAPI 3.1 specification.
Use Alphorn's filters to decide where each notification goes, for example SMS only for priority 4 and above.
Development
pnpm install
pnpm test # builds, then runs the tests against a local fake endpoint
Releasing
- Bump
versioninpackage.json,server.json(both fields),manifest.json, andVERSIONinsrc/server.ts. npm publish --access public- Push a
v<version>tag (or run the Publish to MCP Registry workflow): it publishesserver.jsonto the MCP Registry via GitHub OIDC pnpm bundle, then attachalphorn.mcpbto a GitHub release
License
AGPL-3.0-or-later
Alphorn MCP Fragen
Wie füge ich Alphorn MCP zu Claude Code hinzu?
Führe claude mcp add --env 'ALPHORN_WEBHOOK_URL=<YOUR_ALPHORN_WEBHOOK_URL>' --env 'ALPHORN_API_KEY=<YOUR_ALPHORN_API_KEY>' mcp -- npx -y @alphorn/mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich Alphorn MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet Alphorn MCP?
Er stellt 4 Tools bereit, darunter message, title, priority, tags.
Welche Kanäle kann ich für den Empfang von Benachrichtigungen nutzen?
Je nach deiner Alphorn-Konfiguration kannst du Benachrichtigungen über Slack, Telegram, Discord, E-Mail, SMS, Push und mehr empfangen.