AgentHubAgentHub

ntfy-mcp-server

MCP ServerMCP Registry官方收录

io.github.cyanheads/ntfy-mcp-server · v2.1.0

Send, manage, and replay ntfy push notifications via MCP.

源仓库 ↗

概览

ntfy-mcp-server 是一个MCP Server，收录自 官方 MCP Registry。支持 stdio、streamable-http 传输。本页提供 Cursor、Claude Code 等客户端的安装配置片段。

安装

选择你的平台查看安装方式

{
  "mcpServers": {
    "ntfy-mcp-server": {
      "command": "bun",
      "args": [
        "-y",
        "ntfy-mcp-server"
      ]
    }
  }
}

环境变量

NTFY_SERVERS可选

JSON array of `{ baseUrl, authToken? | authUsername?+authPassword? }` entries — one per ntfy server. First entry is the default base. Auth is scoped to the entry's `baseUrl`; per-call `base_url` overrides that match a registered base forward that server's auth. Takes precedence over the single-server NTFY_BASE_URL / NTFY_AUTH_* shorthand.

NTFY_BASE_URL可选

Single-server shorthand — base URL of the ntfy server (no trailing slash). Used when NTFY_SERVERS is unset.

NTFY_DEFAULT_TOPIC可选

Topic used when a tool call omits `topic`. Treat the topic name as a secret — anyone who knows it can publish or subscribe.

NTFY_AUTH_TOKEN可选

Bearer access token (`tk_…`) for the single-server shorthand. Mutually exclusive with NTFY_AUTH_USERNAME / NTFY_AUTH_PASSWORD.

NTFY_AUTH_USERNAME可选

Basic-auth username for the single-server shorthand — must be set together with NTFY_AUTH_PASSWORD.

NTFY_AUTH_PASSWORD可选

Basic-auth password for the single-server shorthand — must be set together with NTFY_AUTH_USERNAME.

NTFY_REQUEST_TIMEOUT_MS可选

Per-request HTTP timeout in milliseconds.

NTFY_MAX_RETRIES可选

Max retry attempts for transient upstream failures (5xx, network, 429).

MCP_LOG_LEVEL可选

Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

LOGS_DIR可选

Directory for file-based logs (Node only; ignored on Workers).

OTEL_ENABLED可选

Enable OpenTelemetry instrumentation (spans, metrics, completion logs).

NTFY_SERVERS可选

JSON array of `{ baseUrl, authToken? | authUsername?+authPassword? }` entries — one per ntfy server. First entry is the default base. Auth is scoped to the entry's `baseUrl`; per-call `base_url` overrides that match a registered base forward that server's auth. Takes precedence over the single-server NTFY_BASE_URL / NTFY_AUTH_* shorthand.

NTFY_BASE_URL可选

Single-server shorthand — base URL of the ntfy server (no trailing slash). Used when NTFY_SERVERS is unset.

NTFY_DEFAULT_TOPIC可选

Topic used when a tool call omits `topic`. Treat the topic name as a secret — anyone who knows it can publish or subscribe.

NTFY_AUTH_TOKEN可选

Bearer access token (`tk_…`) for the single-server shorthand. Mutually exclusive with NTFY_AUTH_USERNAME / NTFY_AUTH_PASSWORD.

NTFY_AUTH_USERNAME可选

Basic-auth username for the single-server shorthand — must be set together with NTFY_AUTH_PASSWORD.

NTFY_AUTH_PASSWORD可选

Basic-auth password for the single-server shorthand — must be set together with NTFY_AUTH_USERNAME.

NTFY_REQUEST_TIMEOUT_MS可选

Per-request HTTP timeout in milliseconds.

NTFY_MAX_RETRIES可选

Max retry attempts for transient upstream failures (5xx, network, 429).

MCP_SESSION_MODE可选

HTTP session model: 'stateless', 'stateful', or 'auto'.

MCP_HTTP_HOST可选

The hostname for the HTTP server.

MCP_HTTP_PORT可选

The port to run the HTTP server on.

MCP_HTTP_ENDPOINT_PATH可选

The endpoint path for the MCP server.

MCP_AUTH_MODE可选

Authentication mode to use: 'none', 'jwt', or 'oauth'.

MCP_LOG_LEVEL可选

Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

LOGS_DIR可选

Directory for file-based logs (Node only; ignored on Workers).

OTEL_ENABLED可选

Enable OpenTelemetry instrumentation (spans, metrics, completion logs).

相关资源

统一 Manifest

{
  "id": "io.github.cyanheads/ntfy-mcp-server",
  "type": "mcp-server",
  "version": "2.1.0",
  "displayName": "ntfy-mcp-server",
  "description": "Send, manage, and replay ntfy push notifications via MCP.",
  "repository": {
    "url": "https://github.com/cyanheads/ntfy-mcp-server",
    "source": "github"
  },
  "distribution": {
    "packages": [
      {
        "registryType": "npm",
        "identifier": "ntfy-mcp-server",
        "version": "2.1.0",
        "runtimeHint": "bun",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "NTFY_SERVERS",
            "description": "JSON array of `{ baseUrl, authToken? | authUsername?+authPassword? }` entries — one per ntfy server. First entry is the default base. Auth is scoped to the entry's `baseUrl`; per-call `base_url` overrides that match a registered base forward that server's auth. Takes precedence over the single-server NTFY_BASE_URL / NTFY_AUTH_* shorthand."
          },
          {
            "name": "NTFY_BASE_URL",
            "description": "Single-server shorthand — base URL of the ntfy server (no trailing slash). Used when NTFY_SERVERS is unset."
          },
          {
            "name": "NTFY_DEFAULT_TOPIC",
            "description": "Topic used when a tool call omits `topic`. Treat the topic name as a secret — anyone who knows it can publish or subscribe."
          },
          {
            "name": "NTFY_AUTH_TOKEN",
            "description": "Bearer access token (`tk_…`) for the single-server shorthand. Mutually exclusive with NTFY_AUTH_USERNAME / NTFY_AUTH_PASSWORD."
          },
          {
            "name": "NTFY_AUTH_USERNAME",
            "description": "Basic-auth username for the single-server shorthand — must be set together with NTFY_AUTH_PASSWORD."
          },
          {
            "name": "NTFY_AUTH_PASSWORD",
            "description": "Basic-auth password for the single-server shorthand — must be set together with NTFY_AUTH_USERNAME."
          },
          {
            "name": "NTFY_REQUEST_TIMEOUT_MS",
            "description": "Per-request HTTP timeout in milliseconds."
          },
          {
            "name": "NTFY_MAX_RETRIES",
            "description": "Max retry attempts for transient upstream failures (5xx, network, 429)."
          },
          {
            "name": "MCP_LOG_LEVEL",
            "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn')."
          },
          {
            "name": "LOGS_DIR",
            "description": "Directory for file-based logs (Node only; ignored on Workers)."
          },
          {
            "name": "OTEL_ENABLED",
            "description": "Enable OpenTelemetry instrumentation (spans, metrics, completion logs)."
          }
        ]
      },
      {
        "registryType": "npm",
        "identifier": "ntfy-mcp-server",
        "version": "2.1.0",
        "runtimeHint": "bun",
        "transport": "streamable-http",
        "environmentVariables": [
          {
            "name": "NTFY_SERVERS",
            "description": "JSON array of `{ baseUrl, authToken? | authUsername?+authPassword? }` entries — one per ntfy server. First entry is the default base. Auth is scoped to the entry's `baseUrl`; per-call `base_url` overrides that match a registered base forward that server's auth. Takes precedence over the single-server NTFY_BASE_URL / NTFY_AUTH_* shorthand."
          },
          {
            "name": "NTFY_BASE_URL",
            "description": "Single-server shorthand — base URL of the ntfy server (no trailing slash). Used when NTFY_SERVERS is unset."
          },
          {
            "name": "NTFY_DEFAULT_TOPIC",
            "description": "Topic used when a tool call omits `topic`. Treat the topic name as a secret — anyone who knows it can publish or subscribe."
          },
          {
            "name": "NTFY_AUTH_TOKEN",
            "description": "Bearer access token (`tk_…`) for the single-server shorthand. Mutually exclusive with NTFY_AUTH_USERNAME / NTFY_AUTH_PASSWORD."
          },
          {
            "name": "NTFY_AUTH_USERNAME",
            "description": "Basic-auth username for the single-server shorthand — must be set together with NTFY_AUTH_PASSWORD."
          },
          {
            "name": "NTFY_AUTH_PASSWORD",
            "description": "Basic-auth password for the single-server shorthand — must be set together with NTFY_AUTH_USERNAME."
          },
          {
            "name": "NTFY_REQUEST_TIMEOUT_MS",
            "description": "Per-request HTTP timeout in milliseconds."
          },
          {
            "name": "NTFY_MAX_RETRIES",
            "description": "Max retry attempts for transient upstream failures (5xx, network, 429)."
          },
          {
            "name": "MCP_SESSION_MODE",
            "description": "HTTP session model: 'stateless', 'stateful', or 'auto'."
          },
          {
            "name": "MCP_HTTP_HOST",
            "description": "The hostname for the HTTP server."
          },
          {
            "name": "MCP_HTTP_PORT",
            "description": "The port to run the HTTP server on."
          },
          {
            "name": "MCP_HTTP_ENDPOINT_PATH",
            "description": "The endpoint path for the MCP server."
          },
          {
            "name": "MCP_AUTH_MODE",
            "description": "Authentication mode to use: 'none', 'jwt', or 'oauth'."
          },
          {
            "name": "MCP_LOG_LEVEL",
            "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn')."
          },
          {
            "name": "LOGS_DIR",
            "description": "Directory for file-based logs (Node only; ignored on Workers)."
          },
          {
            "name": "OTEL_ENABLED",
            "description": "Enable OpenTelemetry instrumentation (spans, metrics, completion logs)."
          }
        ]
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode"
  ],
  "keywords": [],
  "provenance": {
    "origin": "official-mcp-registry",
    "originalId": "io.github.cyanheads/ntfy-mcp-server",
    "originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.cyanheads%2Fntfy-mcp-server/versions/latest",
    "isOfficial": true,
    "status": "active"
  }
}
ntfy-mcp-server — MCP Server 安装与配置 · AgentHub