广告合作
MCP.so
登录

Ntfy MCP Server

@cyanheads

代码仓库主页

基本信息

分类

其他

许可证

Apache-2.0

传输方式

stdio

作者

cyanheads

关于 Ntfy MCP Server

Send, manage, and replay ntfy push notifications via MCP. STDIO or Streamable HTTP.

#notifications#mcp#ntfy#llm#llm-agent#model-context-protocol#mcp-server

Ntfy MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "ntfy-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT_TYPE=stdio",
        "-e",
        "NTFY_DEFAULT_TOPIC=your-topic-name",
        "ghcr.io/cyanheads/ntfy-mcp-server:latest"
      ]
    }
  }
}

Ntfy MCP Server 工具

4

Send or update a push notification on an ntfy topic.

Clear or delete a previously-sent notification by `sequence_id`.

Poll cached messages from one or more topics with optional filters.

Look up ntfy emoji tag short codes for use in `tags`.

概览

What is ntfy-mcp-server?

ntfy-mcp-server sends, manages, and replays ntfy push notifications via the Model Context Protocol (MCP). It wraps the ntfy HTTP API into four tools and one resource, supporting both STDIO and Streamable HTTP transports. Built for developers integrating push notification workflows into AI agents or MCP-enabled applications.

How to use ntfy-mcp-server?

Add the server to your MCP client’s config file using bunx ntfy-mcp-server@latest or a Docker image, then set the required environment variable NTFY_DEFAULT_TOPIC. For authentication, set a bearer token or basic‑auth credentials. Public ntfy.sh works without an account. The server runs via STDIO by default; for HTTP, set MCP_TRANSPORT_TYPE=http and start with bun run start:http.

Key features of ntfy-mcp-server

  • Four tools: publish, manage, fetch, and search emoji tags
  • One resource providing a snapshot of any topic
  • Full ntfy publish parameters (priority, tags, attachments, actions)
  • Update or delete previously sent messages by sequence ID
  • Multi‑topic polling with optional filters and pagination
  • Authenticated access via bearer token or basic auth
  • Supports multiple ntfy servers per process
  • Retry‑aware HTTP client with configurable timeout

Use cases of ntfy-mcp-server

  • Send critical alerts or notifications from an MCP client
  • Clear/delete notifications after they are acknowledged
  • Replay missed messages or audit topic activity
  • Look up emoji tags to enrich notification content
  • Integrate with public ntfy.sh or a self‑hosted ntfy instance

常见问题

1

What runtime does ntfy-mcp-server require?

Bun v1.3.11 or higher (or Node.js v24+). The server is written in TypeScript.

2

How do I configure multiple ntfy servers?

Use the `NTFY_SERVERS` environment variable – a JSON array of `{ baseUrl, authToken? | authUsername?+authPassword? }` entries. The first entry becomes the default. Per‑call `base_url` overrides only forward auth when matching a registered server.

3

Can I use ntfy-mcp-server without authentication?

Yes. The public ntfy.sh server works out of the box without any credentials. For protected topics, generate a bearer token at `ntfy.sh/account` or use basic auth.

4

Does the server store data locally?

By default it uses in‑memory storage, but the underlying framework supports swappable storage backends: filesystem, Supabase, or Cloudflare KV/R2/D1.

5

What transport modes are available?

STDIO (default) and Streamable HTTP. For HTTP, set `MCP_TRANSPORT_TYPE=http` and configure host/port. Session mode can be `stateless`, `stateful`, or `auto`.

评论

其他 分类下的更多 MCP 服务器

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

Glasswarp

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

广告合作