MCP Сервер для API Mattermost, позволяющий Claude и другим MCP-клиентам взаимодействовать с рабочими пространствами Mattermost.

Особенности

Этот MCP-сервер предоставляет инструменты для взаимодействия с Mattermost, включая:

Тематический мониторинг

Сервер включает систему мониторинга темы, которая может:

Мониторинг определенных каналов для сообщений, содержащих темы, представляющие интерес Запуск по настраиваемому графику (с использованием синтаксиса cron) Отправлять уведомления, когда обсуждаются соответствующие темы Упомяните вас в определенном канале, когда темы будут найдены.

Инструменты канала

• [[Т0]]: Перечислите общедоступные каналы в рабочем пространстве
• [[Т1]]: Получить последние сообщения от канала

Инструменты сообщений

• [[Т2]]: Отправить новое сообщение на канал
• [[Т3]]: Ответ на конкретный поток сообщений
• [[Т4]]: Добавьте реакцию эмодзи к сообщению
• [[Т5]]: Получить все ответы в потоке

Инструменты мониторинга

• [[Т6]]: Немедленно запустить процесс мониторинга темы

Инструменты пользователя

• [[Т7]]: Получите список пользователей в рабочем пространстве

Title changed by Matty

MCP Server for the Mattermost API, enabling Claude and other MCP clients to interact with Mattermost workspaces.

Features

This MCP server provides tools for interacting with Mattermost, including:

Topic Monitoring

The server includes a topic monitoring system that can:

• Monitor specified channels for messages containing topics of interest
• Run on a configurable schedule (using cron syntax)
• Send notifications when relevant topics are discussed
• Mention you in a specified channel when topics are found

Channel Tools

• mattermost_list_channels: List public channels in the workspace
• mattermost_get_channel_history: Get recent messages from a channel

Message Tools

• mattermost_post_message: Post a new message to a channel
• mattermost_reply_to_thread: Reply to a specific message thread
• mattermost_add_reaction: Add an emoji reaction to a message
• mattermost_get_thread_replies: Get all replies in a thread

Monitoring Tools

• mattermost_run_monitoring: Trigger the topic monitoring process immediately

User Tools

• mattermost_get_users: Get a list of users in the workspace
• mattermost_get_user_profile: Get detailed profile information for a user

Setup

1. Clone this repository:

git clone https://github.com/yourusername/mattermost-mcp.git
cd mattermost-mcp

2. Install dependencies:

npm install

3. Configure the server:

   The repository includes a config.json file with placeholder values. For your actual configuration, create a config.local.json file (which is gitignored) with your real credentials:

{
  "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
  }
}

This approach keeps your real credentials out of the repository while maintaining the template for others.

4. Build the server:

npm run build

5. Run the server:

npm start

Topic Monitoring Configuration

The monitoring system can be configured with the following options:

• enabled (boolean): Whether monitoring is enabled
• schedule (string): Cron expression for when to check for new messages (e.g., “*/15 * * * *” for every 15 minutes)
• channels (string[]): Array of channel names to monitor
• topics (string[]): Array of topics to look for in messages
• messageLimit (number): Number of recent messages to analyze per check
• notificationChannelId (string, optional): Channel ID where notifications will be sent. If not provided, the system will automatically use a direct message channel.
• userId (string, optional): Your user ID for mentions in notifications. If not provided, the system will automatically detect the current user.