kcofoni/gotify-mcp

Gotify MCP服务器

Docker Hub概述
一个Model Context Protocol（MCP）服务器，使Claude AI能通过SSE/HTTP传输与Gotify通知服务进行交互。

镜像概述

这是为Gotify设计的MCP服务器，允许Claude AI直接与Gotify通知交互，实现通知的创建、管理及查询等操作。

核心功能

• 📨 创建和管理Gotify消息
• 📥 检索所有应用的消息
• 🔧 管理Gotify应用和客户端
• 🏥 健康监控端点
• 🔌 支持SSE和HTTP传输协议

使用场景

• 通过Claude AI快速发送Gotify通知
• 集成到Claude Code实现通知自动化管理
• 监控Gotify服务状态及消息动态

配置说明

前提条件

创建Docker网络：

bash
docker network create jakenet

Docker Compose部署

yaml
version: '3.8'

services:
  gotify-mcp:
    image: kcofoni/gotify-mcp:latest
    container_name: gotify-mcp
    ports:
      - "3020:3020"
    environment:
      - GOTIFY_URL=https://你的Gotify实例地址.com
      - GOTIFY_CLIENT_TOKEN=你的客户端令牌
      - GOTIFY_APP_TOKEN=你的应用令牌
      - GOTIFY_MCP_PORT=3020
      - GOTIFY_MCP_TRANSPORT=sse
    networks:
      - jakenet
    restart: unless-stopped

networks:
  jakenet:
    external: true

环境变量说明

获取Gotify令牌

1. 客户端令牌：Gotify UI → 客户端 → 创建客户端
2. 应用令牌：Gotify UI → 应用 → 创建应用

Claude Code集成

在~/.claude.json添加：

json
{
  "mcpServers": {
    "gotify": {
      "type": "sse",
      "url": "http://localhost:3020/mcp"
    }
  }
}

重新加载VSCode：Ctrl+Shift+P → "开发者：重新加载窗口"

健康检查

bash
curl http://localhost:3020/health

预期响应：

json
{
  "status": "healthy",
  "gotify_accessible": true
}

可用MCP工具

• create_message - 发送通知
• get_messages - 检索消息
• delete_message - 删除单条消息
• delete_all_messages - 清空消息
• create_application - 创建应用
• get_applications - 列出应用
• update_application - 更新应用
• delete_application - 删除应用
• create_client - 创建客户端
• get_clients - 列出客户端
• get_health - 健康状态
• get_version - Gotify版本

标签

• latest - 最新构建
• v1.0.0 - 稳定版本

链接

• 源码：https://github.com/jmagar/gotify-mcp
• Gotify：gotify.net
• MCP协议：https://modelcontextprotocol.io
• Claude Code：https://claude.ai/claude-code

许可协议

基于https://github.com/jmagar/gotify-mcp