사이트맵 Mattermost API의 서버, Claude 및 기타 MCP 클라이언트를 활성화하여 Mattermost workspaces와 상호 작용합니다.

특징

이 MCP 서버는 Mattermost와 상호 작용하는 도구를 제공합니다.

Topic 모니터링

서버는 다음과 같은 주제 모니터링 시스템을 포함합니다:

• 관심의 주제를 포함하는 메시지에 대한 지정된 채널을 모니터링
• 설정 가능한 일정에 실행 (cron 구문 사용)
• 관련 주제가 논의될 때 알림 보내기
• 주제가 발견 될 때 지정된 채널에서 당신을 언급

채널 도구

• mattermost_list_channels: workspace의 공공 채널 목록
• mattermost_get_channel_history: 채널에서 최근 메시지 받기

메시지 도구

• mattermost_post_message: 채널에 새로운 메시지를 게시
• mattermost_reply_to_thread: 특정 메시지 스레드에 대답
• mattermost_add_reaction: 메시지에 이모티콘 반응 추가
• mattermost_get_thread_replies: 스레드에서 모든 replies 받기

모니터링 도구

• mattermost_run_monitoring: Trigger 주제 모니터링 프로세스 즉시

사용자 도구

• [T7]]: workspace에서 사용자의 목록을 가져옵니다

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.