Ntfy MCP 服务器

简介

Ntfy MCP 服务器是一个基于 Model Context Protocol (MCP) 的工具，用于将长语言模型 (LLM) 连接到 Ntfy.sh 通知服务。该服务器使 LLM 能够通过自然语言处理发送通知、设置提醒和触发警报。

功能

• send_ntfy 工具：允许 LLM 发送自定义的通知到指定的 Ntfy 频道，支持丰富的通知格式。
• 资源模板：
  • ntfy://default：查询默认 Ntfy 主题的信息。
  • ntfy://{topic}：获取特定 Ntfy 主题的详细信息。

工具参数

send_ntfy 工具参数

该工具支持以下参数：

资源模板

ntfy://default

• 描述：返回默认 Ntfy 主题的信息。
• 响应格式：

  {
    "topic": "default",
    "messages": number,
    "created_at": timestamp,
    "updated_at": timestamp
  }
  

ntfy://{topic}

• 描述：返回指定主题的详细信息。
• 示例 URL：ntfy://alerts
• 响应格式：

  {
    "topic": string,
    "messages": array of messages,
    "created_at": timestamp,
    "updated_at": timestamp
  }
  

使用案例

示例 1：长时间运行的任务通知

<TN>
  <action>tnfy Notify</action>
  <parameters>
    <topic>default</topic>
    <title>Long-running Task Complete</title>
    <message>The background data processing task has finished successfully.</message>
    <tags>info</tags>
  </parameters>
</TN>

示例 2：设置提醒

<TN>
  <action>tnfy Schedule Reminder</action>
  <parameters>
    <topic>reminders</topic>
    <title>Team Meeting</title>
    <message>Don't forget the team meeting at 3 PM today.</message>
    <tags>calendar, reminder</tags>
    <priority>4</priority>
  </parameters>
</TN>

可用脚本

# 安装依赖
npm install

# 编译代码
npm run build

# 启动开发服务器
npm start

# 测试命令
npm test

贡献指南

如何贡献

1. 报告问题：通过 GitHub Issues 提交错误或功能请求。
2. 提交修复： Fork 仓库，创建分支，提交 Pull Request。
3. 开发新特性：查看未完成的功能列表并开始贡献。

开发最佳实践

• 遵循 TypeScript 最佳实践并保持强类型。
• 确保代码可读性和文档清晰度。
• 提交小而频繁的更改，并提供详细的提交信息。
• 在合并请求中包含相关测试用例。

许可证

项目以 MIT License 分发，具体条款见 LICENSE 文件。

致谢

感谢以下项目的贡献者：

• 开发团队：[Your Name], [Collaborator Name]
• 社区贡献者：[Contributor 1], [Contributor 2]

如需了解更多信息，请访问我们的 GitHub 页面 或联系 项目维护人员。