Mattermost MCP サーバー

Mattermost API 用の MCP サーバー。Claude や他の MCP クライアントが Mattermost ワークスペースと対話できるようにします。

特徴

この MCP サーバーは、Mattermost と対話するための次のようなツールを提供します。

トピックモニタリング

サーバーには、次の機能を備えたトピック監視システムが含まれています。

• 関心のあるトピックを含むメッセージを特定のチャネルで監視します

• 設定可能なスケジュールで実行する（cron 構文を使用）

• 関連するトピックが議論されたときに通知を送信する

• トピックが見つかったときに、指定されたチャンネルであなたをメンションします

チャンネルツール

• mattermost_list_channels : ワークスペース内のパブリックチャンネルを一覧表示する

• mattermost_get_channel_history : チャンネルから最近のメッセージを取得する

メッセージツール

• mattermost_post_message : チャンネルに新しいメッセージを投稿する

• mattermost_reply_to_thread : 特定のメッセージスレッドに返信する

• mattermost_add_reaction : メッセージに絵文字反応を追加する

• mattermost_get_thread_replies : スレッド内のすべての返信を取得する

監視ツール

• mattermost_run_monitoring : トピック監視プロセスを直ちにトリガーする

ユーザーツール

• mattermost_get_users : ワークスペース内のユーザーのリストを取得する

• mattermost_get_user_profile : ユーザーの詳細なプロフィール情報を取得する

Related MCP server: Tembo MCP Server

設定

1. このリポジトリをクローンします:

2. 依存関係をインストールします:

3. サーバーを構成します。

   リポジトリにはプレースホルダ値が入ったconfig.jsonファイルが含まれています。実際の設定には、実際の認証情報を含むconfig.local.jsonファイル（gitignored）を作成してください。

   { "mattermostUrl": "https://your-mattermost-instance.com/api/v4", "token": "your-personal-access-token", "teamId": "your-team-id", "monitoring": { "enabled": false, "schedule": "*/15 * * * *", "channels": ["town-square", "off-topic"], "topics": ["tv series", "champions league"], "messageLimit": 50 } }

   このアプローチにより、実際の資格情報はリポジトリから除外され、他のユーザーのテンプレートも維持されます。

4. サーバーを構築します。

5. サーバーを実行します。

トピック監視構成

監視システムは、次のオプションで構成できます。

• enabled (boolean): 監視が有効かどうか

• schedule （文字列）：新しいメッセージを確認するタイミングを指定するCron式（例：15分ごとに「*/15 * * * *」）

• channels (文字列[]): 監視するチャンネル名の配列

• topics (string[]): メッセージ内で検索するトピックの配列

• messageLimit (数値): チェックごとに分析する最近のメッセージの数

• notificationChannelId (文字列、オプション): 通知を送信するチャネルID。指定されていない場合は、システムは自動的にダイレクトメッセージチャネルを使用します。

• userId (文字列、オプション): 通知に表示されるユーザーID。指定しない場合は、システムが現在のユーザーを自動的に検出します。

監視を有効にするには、 config.local.jsonファイルでenabledをtrueに設定します。

手動で監視を実行する

監視プロセスを手動でトリガーするには、いくつかの方法があります。

1. 提供されているスクリプトを使用する:

   • ./run-monitoring-http.sh - サーバーを再起動せずに HTTP 経由で監視をトリガーします (推奨)

   • ./run-monitoring.sh - 監視を有効にした新しいサーバーインスタンスを起動します

   • ./trigger-monitoring.sh - 監視プロセスを実行して終了します（cronジョブに便利です）

   • ./view-channel-messages.js <channel-name> [count] - チャンネル内の最後のメッセージを表示します

   • ./analyze-channel.js <channel-name> [count] - チャネル内のメッセージ統計を分析する

   • ./get-last-message.js <channel-name> - チャンネルから最後のメッセージを取得します

2. コマンドラインインターフェース (CLI) の使用:

   • サーバーの実行中に、ターミナルに次のコマンドのいずれかを入力するだけです。

     • run - 監視プロセスを実行する

     • monitor - runと同じ

     • check - runと同じ

   • その他の利用可能なコマンド:

     • help - 利用可能なコマンドを表示する

     • exit - サーバーをシャットダウンする

3. MCPツールの使用:

   • MCPインターフェースを介してmattermost_run_monitoringツールを使用する

   • これにより、興味のあるトピックについて、設定されたすべてのチャンネルがすぐにチェックされます。

4. コマンドラインフラグの使用:

   • --run-monitoringフラグでサーバーを起動します: GXP6

   • これにより、サーバーの起動直後に監視プロセスが実行されます。

   • 監視プロセスが完了した後に終了するには--exit-after-monitoringを追加します: GXP7

   • これは、cronジョブから監視プロセスを実行するのに役立ちます。

ツールの詳細

チャンネルツール

mattermost_list_channels

• ワークスペース内のパブリックチャンネルを一覧表示する

• オプション入力:

  • limit （数値、デフォルト：100、最大：200）：返されるチャンネルの最大数

  • page （数値、デフォルト：0）：ページ番号

• 戻り値: IDと情報を含むチャンネルのリスト

mattermost_get_channel_history

• チャンネルから最近のメッセージを取得する

• 必要な入力:

  • channel_id (文字列): チャンネルのID

• オプション入力:

  • limit （数値、デフォルト：30）：取得するメッセージの数

  • page （数値、デフォルト：0）：ページ番号

• 戻り値: メッセージとその内容およびメタデータのリスト

メッセージツール

mattermost_post_message

• Mattermostチャンネルに新しいメッセージを投稿する

• 必要な入力:

  • channel_id (文字列): 投稿先のチャンネルのID

  • message (文字列): 投稿するメッセージテキスト

• 戻り値: メッセージ投稿の確認とID

mattermost_reply_to_thread

• 特定のメッセージスレッドに返信する

• 必要な入力:

  • channel_id (文字列): スレッドを含むチャネル

  • post_id (文字列): 親メッセージのID

  • message （文字列）：返信テキスト

• 返品: 返信確認とID

mattermost_add_reaction

• メッセージに絵文字リアクションを追加する

• 必要な入力:

  • channel_id (文字列): メッセージを含むチャネル

  • post_id (文字列): 反応するメッセージID

  • emoji_name (文字列): コロンを除いた絵文字名

• 返品：反応確認

mattermost_get_thread_replies

• メッセージスレッド内のすべての返信を取得する

• 必要な入力:

  • channel_id (文字列): スレッドを含むチャネル

  • post_id (文字列): 親メッセージのID

• 戻り値: コンテンツとメタデータを含む返信のリスト

ユーザーツール

mattermost_get_users

• 基本的なプロフィール情報を持つワークスペースユーザーのリストを取得します

• オプション入力:

  • limit （数値、デフォルト：100、最大：200）：返されるユーザーの最大数

  • page （数値、デフォルト：0）：ページ番号

• 戻り値: 基本プロフィールを持つユーザーのリスト

mattermost_get_user_profile

• 特定のユーザーの詳細なプロフィール情報を取得する

• 必要な入力:

  • user_id (文字列): ユーザーのID

• 返されるもの: 詳細なユーザープロフィール情報

Claude Desktopでの使用

claude_desktop_config.jsonに以下を追加します。

トラブルシューティング

権限エラーが発生した場合は、次の点を確認してください。

1. あなたの個人アクセストークンには必要な権限があります

2. トークンは設定に正しくコピーされました

3. MattermostのURLとチームIDは正しいです

HTTPエンドポイント

サーバーはリモート制御用の HTTP エンドポイントを公開します。

• 実行監視: http://localhost:3456/run-monitoring

  • 監視プロセスを直ちに開始します

  • 成功/エラー情報を含むJSONレスポンスを返します

• ステータスの確認: http://localhost:3456/status

  • サーバーと監視ステータスに関する情報を返します

  • 健康診断に役立つ

これらのエンドポイントは、curl または任意の HTTP クライアントで使用できます。

ユーティリティスクリプト

実行監視http.sh

このスクリプトは、HTTP エンドポイントを介して監視プロセスをトリガーします。

これは、監視を手動でトリガーする場合に推奨される方法です。

• サーバーを再起動しない

• スケジュールされた監視を妨げない

• どの端末からでも確実に動作します

チャネルメッセージの表示.js

このスクリプトを使用すると、任意のチャネルの最新のメッセージを表示できます。

スクリプトは次のように表示されます:

• チャンネル情報（名前、目的、メッセージ総数）

• タイムスタンプとユーザー名が付いた最新のメッセージ

• チャンネルが存在しない場合は、利用可能なすべてのチャンネルがリストされます

分析チャンネル.js

このスクリプトは、チャネル内のメッセージに関する詳細な統計情報を提供します。

スクリプトは次のように表示されます:

• チャンネル情報とメタデータ

• 合計メッセージ数（システムメッセージを含む）

• ユーザーメッセージとシステムメッセージの内訳

• ユーザー別のメッセージ数

• チャンネル内の最新のメッセージ

最後のメッセージを取得する.js

このスクリプトは、チャネルから最新のメッセージのみを取得します。

スクリプトは次のように表示されます:

• 送信者のユーザーIDとユーザー名

• メッセージのタイムスタンプ

• メッセージの全文

ライセンス

この MCP サーバーは MIT ライセンスに基づいてライセンスされます。