AI导哈

Mattermost服务器工具集

MCP Mattermost Server是一个功能丰富的工具集，提供对Playbooks、Runs、Tasks和上下文工程的全面支持，适用于团队协作和自动化任务管理。

  • by leonardokasat-cientistavenda
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 leonardokasat-cientistavenda/mcp-playbooks

使用说明

MCP Mattermost Server

MCP server para Mattermost com suporte completo a Playbooks, Runs, Tasks e Context Engineering.

Features

  • Team dinâmico - Não fixo na config, passado por chamada
  • 81 tools organizadas em 8 grupos + 9 helpers
  • Props support - User, Team, Channel, Post
  • Playbooks completo - PropertyFields, PropertyValues
  • Tasks - Check batch (fase inteira), assignee, webhooks

Instalação

npm install
cp .env.example .env
# Editar .env com suas credenciais
npm run build

Configuração

MM_URL=https://seu-mattermost.com
MM_TOKEN=seu-token-aqui

Uso com Claude Desktop

{
  "mcpServers": {
    "mattermost": {
      "command": "node",
      "args": ["/caminho/para/mcp-mattermost/dist/index.js"],
      "env": {
        "MM_URL": "https://seu-mattermost.com",
        "MM_TOKEN": "seu-token"
      }
    }
  }
}

Tools Disponíveis

Index

Tool Descrição
mm_help Lista os 8 grupos e suas funções

1. User (6 tools)

Tool Descrição
mm_user_help Helper do grupo
mm_user_get Busca user por ID
mm_user_get_by_username Busca user por @username
mm_user_search Lista/busca usuários
mm_user_create Cria novo usuário
mm_user_update Atualiza perfil
mm_user_update_props Atualiza props (config agente)

2. Webhook (10 tools)

Tool Descrição
mm_webhook_help Helper do grupo
mm_webhook_outgoing_create Cria webhook outgoing
mm_webhook_outgoing_list Lista webhooks outgoing
mm_webhook_outgoing_get Busca webhook por ID
mm_webhook_outgoing_update Atualiza webhook
mm_webhook_outgoing_delete Remove webhook
mm_webhook_incoming_create Cria webhook incoming
mm_webhook_incoming_list Lista webhooks incoming
mm_webhook_incoming_get Busca webhook por ID
mm_webhook_incoming_update Atualiza webhook
mm_webhook_incoming_delete Remove webhook

3. Team (7 tools)

Tool Descrição
mm_team_help Helper do grupo
mm_team_get Busca time por ID
mm_team_get_by_name Busca time por nome
mm_team_list Lista todos os times
mm_team_update_props Atualiza props do time
mm_team_get_members Lista membros
mm_team_add_member Adiciona membro
mm_team_remove_member Remove membro

4. Channel (11 tools)

Tool Descrição
mm_channel_help Helper do grupo
mm_channel_get Busca canal por ID
mm_channel_get_by_name Busca canal por nome
mm_channel_list Lista canais do time
mm_channel_search Busca canais
mm_channel_create Cria canal
mm_channel_update Atualiza canal
mm_channel_update_props Atualiza props
mm_channel_delete Remove canal
mm_channel_get_members Lista membros
mm_channel_add_member Adiciona membro
mm_channel_remove_member Remove membro

5. Post (14 tools)

Tool Descrição
mm_post_help Helper do grupo
mm_post_get Busca post por ID
mm_post_get_channel Lista posts do canal
mm_post_get_thread Lista posts da thread
mm_post_search Busca posts
mm_post_create Cria post (message + props)
mm_post_update Atualiza message
mm_post_update_props Atualiza props
mm_post_delete Remove post
mm_post_pin Fixa post
mm_post_unpin Desfixa post
mm_post_get_pinned Lista fixados
mm_post_reaction_add Adiciona emoji
mm_post_reaction_remove Remove emoji
mm_post_reaction_get Lista reactions

6. Playbook (9 tools)

Tool Descrição
mm_playbook_help Helper do grupo
mm_playbook_get Busca playbook por ID
mm_playbook_list Lista playbooks
mm_playbook_create Cria playbook
mm_playbook_update Atualiza (webhooks, channel_mode)
mm_playbook_delete Arquiva playbook
mm_playbook_field_list Lista property fields
mm_playbook_field_create Cria field
mm_playbook_field_update Atualiza field
mm_playbook_field_delete Remove field

7. Run (13 tools)

Tool Descrição
mm_run_help Helper do grupo
mm_run_get Busca run por ID
mm_run_get_by_channel Busca run por channel_id
mm_run_list Lista runs
mm_run_start Inicia run (link canal existente)
mm_run_update Atualiza run
mm_run_finish Finaliza run
mm_run_end Encerra run
mm_run_restart Reinicia run
mm_run_status_update Posta status
mm_run_change_owner Troca owner
mm_run_property_list Lista fields + values
mm_run_property_get Busca value
mm_run_property_set Define value (contexto)

8. Task (11 tools)

Tool Descrição
mm_task_help Helper do grupo
mm_task_get Busca task específica
mm_task_add Adiciona task
mm_task_update Atualiza (description=prompt)
mm_task_delete Remove task
mm_task_set_state Define estado
mm_task_check Marca como done
mm_task_uncheck Desmarca
mm_task_set_assignee Atribui a usuário
mm_task_run_command Executa slash
mm_task_reorder Reordena
mm_task_check_checklist Marca fase inteira

Gavetas de Dados

Local Campo Tamanho Uso
Post message 16KB Conteúdo visível
Post props 64KB Metadados invisíveis
Channel props 64KB Config do canal
User props 64KB Config do agente
Team props 64KB Config compartilhada
Run PropertyValues 5MB Contrato, contexto global
Task description 64KB Prompt da task

Para Context Engineering

LEITURA (Context Builder):
├── Run.PropertyValues     → Contrato M2, contexto
├── Task.description       → Prompt da task
├── Channel.Posts          → Histórico
└── Post.props             → Metadados

ESCRITA (LLM executa):
├── Post.message + props   → Resposta + metadados
├── Run.PropertyValues     → Output estruturado
├── Task.state = closed    → Marca feito
└── Task.assignee_id       → Próxima task

Licença

MIT

相关 MCP