mattermost-mcp-server

This project implements a Model Context Protocol (MCP) server for Mattermost integration. It connects to Mattermost API endpoints to retrieve and process various information, making it available through standard MCP transports.

Features

• Connects to Mattermost API endpoints

• Supports multiple transport modes:

  • SSE (Server-Sent Events)

  • Standard I/O

• Real-time message processing

• Team and channel-specific monitoring

• Secure token-based authentication

Requirements

• Node.js >= 22

• npm >= 10

• dotenvx

  • dotenvx

Setup

1. Clone this repository:

2. Install dependencies:

3. Set up your environment variables:

Required environment variables:

• MCP_PORT: Port number for SSE transport mode (default: 8201)

• MATTERMOST_ENDPOINT: Your Mattermost server URL

• MATTERMOST_TOKEN: Your Mattermost authentication token

• MATTERMOST_TEAM_ID: The ID of the team to monitor

• MATTERMOST_CHANNELS: Comma-separated list of channel names to monitor

4. Build the server:

Usage

The server can be run in two transport modes:

SSE Transport Mode

Standard I/O Transport Mode

Development

• npm run dev: Start the server in development mode with hot reload

• npm run lint: Run ESLint

• npm run format: Format code using Prettier

• npm test: Run tests

• npm run inspect: Run MCP inspector

References

• Model Context Protocol TypeScript SDK

• MCP inspector

License

MIT