npx mcpbar@latest edit -c claude

mcp-server-mattermost

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

• Secure, token-based connection to Mattermost API endpoints
• Supports multiple transport modes:
  • stdio
  • http-stream
  • sse
• Search for messages across multiple Mattermost channels
• Customizable default channels and message fetch limits

Requirements

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

Setup

1. Clone this repository:

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

2. Install dependencies:

npm install

3. Set up your environment variables:

# Create .env file
cp .env.example .env

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

Required environment variables:

• 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:

npm run build

Usage

The server supports three transport modes: stdio (default), sse, and http-stream.

Standard I/O Transport Mode

npm run start:stdio
# or
npx dotenvx run -q -- "node dist/main.js --transport stdio"

SSE Transport Mode

npm run start:sse
# or
npx dotenvx run -q -- "node dist/main.js --transport sse"

HTTP Transport Mode

npm run start:http
# or
npx dotenvx run -q -- "node dist/main.js --transport http-stream"

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