Mattermost MCP Server

🚀 mattermost-mcp-server

このプロジェクトは、Mattermostと統合されたモデルコンテキストプロトコル（MCP）サーバーを実装しています。Mattermost APIエンドポイントに接続し、様々な情報を取得・処理し、標準的なMCPトランスポートを通じてこれらの情報を提供します。

🚀 クイックスタート

このセクションでは、mattermost-mcp-serverの基本的な使い方を説明します。

✨ 主な機能

• Mattermost APIエンドポイントへの接続
• 複数のトランスポート方式のサポート：
  • SSE（サーバー送信イベント）
  • 標準入出力
• リアルタイムメッセージ処理
• チームとチャンネルの特定の監視
• トークンベースのセキュリティ認証

📦 インストール

前提条件

• Node.js >= 22
• npm >= 10
• dotenvx
  • dotenvx

インストール手順

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

git clone https://github.com/kakehashi-inc/mattermost-mcp-server.git
cd mattermost-mcp-server

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

npm install

3. 環境変数を設定します：

# .envファイルを作成します
cp .env.example .env

# .envファイルを暗号化します（オプションですが、本番環境では推奨）
dotenvx encrypt

必要な環境変数：

• MCP_PORT：SSEトランスポートモードのポート番号（デフォルト：8201）
• MATTERMOST_ENDPOINT：あなたのMattermostサーバーのURL
• MATTERMOST_TOKEN：あなたのMattermost認証トークン
• MATTERMOST_TEAM_ID：監視対象のチームID
• MATTERMOST_CHANNELS：監視対象のチャンネル名をカンマ区切りで列挙

4. サーバーをビルドします：

npm run build

💻 使用例

基本的な使用法

サーバーは2つのトランスポートモードで実行できます。

SSE トランスポートモード

npm start

標準I/O トランスポートモード

npm start -- --stdio

開発時の使用法

• npm run dev：開発モードでサーバーを起動し、ホットリロードをサポートします。
• npm run lint：ESLintを実行します。
• npm run format：Prettierを使用してコードをフォーマットします。
• npm test：テストを実行します。
• npm run inspect：MCPチェックツールを実行します。

📚 ドキュメント

参考資料

• モデルコンテキストプロトコルTypeScript SDK
• MCPチェックツール

📄 ライセンス

MIT