mattermost-mcp-server

mcp-server-mattermost

このプロジェクトは、Mattermost との連携に対応する Model Context Protocol（MCP）サーバーを実装します。Mattermost API エンドポイントに接続してさまざまな情報を取得・処理し、標準の MCP トランスポートを通じて利用できるようにします。

機能

• トークンベースの安全な Mattermost API エンドポイントへの接続
• 複数のトランスポートモードに対応：
  • stdio
  • http-stream
  • sse
• 複数の Mattermost チャンネルを対象にメッセージを検索
• デフォルトのチャンネルとメッセージ取得数の上限をカスタマイズ可能

要件

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

セットアップ

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

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

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

npm install

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

必須の環境変数

• MATTERMOST_ENDPOINT：Mattermost サーバーの URL
• MATTERMOST_TOKEN：Mattermost の認証トークン
• MATTERMOST_TEAM：監視するチームの名前
• MATTERMOST_CHANNELS：監視するチャンネル名をカンマ区切りで指定したリスト

環境変数の設定方法

方法 1：環境変数を直接設定

export MATTERMOST_ENDPOINT="https://your-mattermost-server.com"
export MATTERMOST_TOKEN="your-token-here"
export MATTERMOST_TEAM="your-team-name"
export MATTERMOST_CHANNELS="general,random,dev"

方法 2：.env ファイルを使用（dotenvx を使用）

# Install dotenvx (optional)
npm install -g @dotenvx/dotenvx

# Create .env file
cp .env.example .env
# Edit .env file with your values

# Encrypt your .env file (recommended for production)
dotenvx encrypt

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

npm run build

使用方法

サーバーは、stdio（デフォルト）、sse、http-stream の 3 つのトランスポートモードに対応しています。

標準入出力トランスポートモード

# Using npm scripts (with dotenvx)
npm run start:stdio

# Direct execution
node dist/main.js --transport stdio

# Using npx
npx mcp-server-mattermost --transport stdio

SSE トランスポートモード

# Using npm scripts (with dotenvx)
npm run start:sse

# Direct execution
node dist/main.js --transport sse

HTTP トランスポートモード

# Using npm scripts (with dotenvx)
npm run start:http

# Direct execution
node dist/main.js --transport http-stream

Claude Desktop との連携

この MCP サーバーを Claude Desktop で使用するには、以下の設定を Claude Desktop の設定に追加します：

設定例

{
  "mcpServers": {
    "mattermost": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-mattermost@latest",
        "--transport", "stdio",
        "--endpoint", "https://your-mattermost-server/api/v4",
        "--token", "your_personal_access_token",
        "--team", "your_team_name",
        "--channels", "town-square,general,your_channel_name"
      ]
    }
  }
}

開発

• npm run dev：ホットリロードを有効にして、開発モードでサーバーを起動
• npm run lint：ESLint を実行
• npm run format：Prettier でコードをフォーマット
• npm test：テストを実行
• npm run inspect：MCP inspector を実行

参考資料

• Model Context Protocol TypeScript SDK
• MCP inspector

ライセンス

MIT