MCP Notify

🚀 MCP Notify

MCPレジストリエコシステムのリアルタイム監視と通知を行います。

🚀 クイックスタート

MCP Notifyは、公式MCPレジストリの変更を監視し、Discord、Slack、メール、Webhookなどを通じて即時通知を配信します。以下に、いくつかの利用方法を紹介します。

ホステッドサービスの利用

# APIを介してWebhookサブスクリプションを作成
curl -X POST https://watch.mcpregistry.dev/api/v1/subscriptions \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My DeFi Alerts",
    "filters": {
      "keywords": ["defi", "ethereum", "swap"],
      "namespaces": ["io.github.*"]
    },
    "channels": [{
      "type": "discord",
      "config": {
        "webhook_url": "https://discord.com/api/webhooks/..."
      }
    }]
  }'

Dockerでの自前ホスティング

# リポジトリをクローン
git clone https://github.com/nirholas/mcp-notify.git
cd mcp-notify

# 環境を設定
cp .env.example .env
# .envを自分の設定で編集

# サービスを起動
docker compose up -d

# ダッシュボードにアクセスするには、http://localhost:8080 を開きます

CLIの利用

# CLIをインストール
go install github.com/nirholas/mcp-notify/cmd/mcp-notify-cli@latest

# 最近の変更を確認
mcp-notify-cli changes --since 24h

# ライブ出力で監視
mcp-notify-cli watch --filter "defi,blockchain" --output json

# 通知を購読
mcp-notify-cli subscribe \
  --discord-webhook "https://discord.com/api/webhooks/..." \
  --filter "io.github.myorg/*"

✨ 主な機能

コア機能

• リアルタイム監視：MCPレジストリを設定可能な間隔でポーリングします。
• スマート差分検出：新しいサーバー、更新、バージョン変更、削除を検出します。
• 柔軟なフィルタリング：特定の名前空間、キーワード、またはサーバーパターンにサブスクライブできます。
• 変更履歴：検出されたすべての変更の完全な監査トレイルとタイムスタンプを記録します。

通知チャネル

• Discord：サーバーの詳細と直接リンクを含むリッチな埋め込み表示が可能です。
• Slack：アクションボタン付きのインタラクティブなメッセージを送信できます。
• メール：即時、毎時、毎日、毎週のダイジェストメールを配信します。
• Webhook：カスタム統合用の汎用HTTP Webhookをサポートします。
• RSS/Atom：任意のフィードリーダーで購読できます。
• Telegram：Telegram Bot APIを介したボット通知が可能です。
• Microsoft Teams：完全なTeams統合を備えたアダプティブカードを送信できます。

デプロイメントオプション

• ホステッドサービス：watch.mcpregistry.devで提供されるホステッドインスタンスを利用できます。
• 自前ホスティング：DockerまたはKubernetesを介して独自のインスタンスをデプロイできます。
• CLIツール：一度だけのチェックやローカル監視を行うことができます。

開発者向け機能

• REST API：プログラムによるサブスクリプション管理用の完全なAPIを提供します。
• Webダッシュボード：視覚的な設定と監視インターフェースを提供します。
• Go SDK：独自のアプリケーションに組み込むことができます。
• OpenAPI仕様：任意の言語でクライアントを生成できます。

🏗️ アーキテクチャ

┌────────────────────────────────────────────────────────────────┐
│                        MCP Notify                              │
├────────────────────────────────────────────────────────────────┤
│                                                                │
│  ┌──────────┐    ┌──────────┐    ┌──────────────────────────┐  │
│  │  Poller  │───▶│  Differ  │───▶│  Notification Dispatcher │  │
│  └──────────┘    └──────────┘    └──────────────────────────┘  │
│       │               │                      │                 │
│       ▼               ▼                      ▼                 │
│  ┌──────────┐    ┌──────────┐    ┌──────────────────────────┐  │
│  │ Registry │    │ Snapshot │    │        Channels          │  │
│  │   API    │    │  Store   │    │  ┌───────┐ ┌───────────┐ │  │
│  └──────────┘    └──────────┘    │  │Discord│ │   Slack   │ │  │
│                       │          │  └───────┘ └───────────┘ │  │
│                       ▼          │  ┌───────┐ ┌───────────┐ │  │
│                  ┌──────────┐    │  │ Email │ │  Webhook  │ │  │
│                  │PostgreSQL│    │  └───────┘ └───────────┘ │  │
│                  └──────────┘    │  ┌───────┐               │  │
│                                  │  │  RSS  │               │  │
│                                  │  └───────┘               │  │
│                                  └──────────────────────────┘  │
│                                                                │
│  ┌──────────────────────────────────────────────────────────┐  │
│  │                       REST API                           │  │
│  │  /subscriptions  /changes  /feeds  /health  /metrics     │  │
│  └──────────────────────────────────────────────────────────┘  │
│                                                                │
│  ┌──────────────────────────────────────────────────────────┐  │
│  │                    Web Dashboard                         │  │
│  │  React + TypeScript + Tailwind + shadcn/ui               │  │
│  └──────────────────────────────────────────────────────────┘  │
│                                                                │
└────────────────────────────────────────────────────────────────┘

📦 インストール

前提条件

• Go 1.22以上（ソースからビルドする場合）
• PostgreSQL 15以上（永続化用）
• Redis 7以上（キャッシュ用、オプション）
• DockerとDocker Compose（コンテナ化デプロイメント用）

ソースからのインストール

git clone https://github.com/nirholas/mcp-notify.git
cd mcp-notify
make build
./bin/mcp-notify --config config.yaml

Dockerを使用したインストール

docker pull ghcr.io/nirholas/mcp-notify:latest
docker run -p 8080:8080 -v $(pwd)/config.yaml:/app/config.yaml \
  ghcr.io/nirholas/mcp-notify:latest

Kubernetesを使用したインストール

helm repo add mcp-notify https://YOUR_USERNAME.github.io/mcp-notify
helm install mcp-notify mcp-notify/mcp-notify \
  --set config.registryUrl=https://registry.modelcontextprotocol.io \
  --set notifications.discord.enabled=true

🔧 設定

環境変数

設定ファイル

# config.yaml
server:
  port: 8080
  host: "0.0.0.0"
  cors:
    origins: ["*"]

registry:
  url: "https://registry.modelcontextprotocol.io"
  poll_interval: 5m
  timeout: 30s
  retry_attempts: 3

database:
  url: "postgres://user:pass@localhost:5432/mcp_watch?sslmode=disable"
  max_connections: 25
  
redis:
  url: "redis://localhost:6379/0"
  
notifications:
  discord:
    enabled: true
    rate_limit: 30/min
  slack:
    enabled: true
    rate_limit: 30/min
  email:
    enabled: true
    smtp:
      host: "smtp.example.com"
      port: 587
      username: ""
      password: ""
      from: "mcp-notify@example.com"
  webhook:
    enabled: true
    timeout: 10s
    retry_attempts: 3
  rss:
    enabled: true
    items_per_feed: 100
    
telemetry:
  metrics:
    enabled: true
    port: 9090
  tracing:
    enabled: false
    endpoint: ""

📡 APIリファレンス

サブスクリプション

# サブスクリプションを作成
POST /api/v1/subscriptions

# サブスクリプションを一覧表示
GET /api/v1/subscriptions

# サブスクリプションを取得
GET /api/v1/subscriptions/{id}

# サブスクリプションを更新
PUT /api/v1/subscriptions/{id}

# サブスクリプションを削除
DELETE /api/v1/subscriptions/{id}

# サブスクリプションを一時停止/再開
POST /api/v1/subscriptions/{id}/pause
POST /api/v1/subscriptions/{id}/resume

変更

# 最近の変更を取得
GET /api/v1/changes?since=2025-01-01T00:00:00Z&limit=100

# 変更の詳細を取得
GET /api/v1/changes/{id}

# 特定のサーバーの変更を取得
GET /api/v1/changes?server=io.github.example/my-server

フィード

# RSSフィード（すべての変更）
GET /api/v1/feeds/rss

# Atomフィード（すべての変更）
GET /api/v1/feeds/atom

# フィルター付きフィード
GET /api/v1/feeds/rss?namespace=io.github.*&keywords=defi

ヘルスチェックとメトリクス

# ヘルスチェック
GET /health

# レディネスチェック
GET /ready

# Prometheusメトリクス
GET /metrics

サーバーを実行しているときには、/api/docsで完全なAPIドキュメントを参照できます。また、docs/api/openapi.yamlも参照してください。

🔔 通知形式

Discord

リッチな埋め込み表示には以下が含まれます。

• サーバー名と説明
• 変更の種類（新規、更新、削除）
• バージョン情報
• レジストリへの直接リンク
• パッケージレジストリのリンク（npm、PyPIなど）

Slack

インタラクティブなメッセージには以下が含まれます。

• 拡張可能なサーバー詳細
• クイックアクションボタン
• 関連する変更のスレッドサポート

メールダイジェスト

設定可能なダイジェストメール：

• 即時（変更ごと）
• 毎時の要約
• 毎日のダイジェスト
• 毎週のまとめ

Webhookペイロード

{
  "event_type": "server.updated",
  "timestamp": "2025-01-04T12:00:00Z",
  "server": {
    "name": "io.github.example/my-server",
    "description": "An example MCP server",
    "version": "2.0.0",
    "previous_version": "1.5.0",
    "packages": [...],
    "remotes": [...]
  },
  "changes": [
    {
      "field": "version",
      "old_value": "1.5.0",
      "new_value": "2.0.0"
    },
    {
      "field": "description",
      "old_value": "...",
      "new_value": "..."
    }
  ],
  "registry_url": "https://registry.modelcontextprotocol.io/v0/servers/io.github.example%2Fmy-server"
}

📸 スクリーンショット

📖 ドキュメント

🧪 テスト

# 単体テストを実行
make test

# 統合テストを実行（Dockerが必要）
make test-integration

# エンドツーエンドテストを実行
make test-e2e

# カバレッジ付きですべてのテストを実行
make test-coverage

🤝 コントリビュート

コントリビューションを歓迎します！詳細なガイドラインはCONTRIBUTING.mdを参照してください。

開発環境のセットアップ

# リポジトリをクローン
git clone https://github.com/nirholas/mcp-notify.git
cd mcp-notify

# 依存関係をインストール
make deps

# 開発用サービスを起動
make dev-services

# ホットリロード付きで開発モードで実行
make dev

# リンターを実行
make lint

# コードを生成（APIクライアント、モックなど）
make generate

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細はLICENSEファイルを参照してください。

🙏 謝辞

• Model Context Protocolチームの皆様、プロトコルとレジストリの提供に感謝いたします。
• MCP Registryのメンテナーの皆様、ご尽力いただきありがとうございます。
• このプロジェクトに貢献してくれたすべての方々、ありがとうございます。

📞 サポート

• ドキュメント：docs/
• 問題報告：GitHub Issues
• ディスカッション：GitHub Discussions
• X (Twitter)：@nichxbt

MCPコミュニティのために愛を込めて作られました

MCPコミュニティのために愛を込めて構築されました

https://modelcontextprotocol.name/mcp/mcp-notify

{
  "mcpServers": {
    "mcp-notify": {
      "type": "http",
      "url": "https://modelcontextprotocol.name/mcp/mcp-notify"
    }
  }
}

curl -X POST https://modelcontextprotocol.name/mcp/mcp-notify \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_mcp_servers","arguments":{}}}'

curl -X POST https://modelcontextprotocol.name/mcp/mcp-notify \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_mcp_servers","arguments":{"query":"crypto"}}}'

curl -X POST https://modelcontextprotocol.name/mcp/mcp-notify \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'