Mattermost MCP Server

Mattermost MCP Server

site icon
2025.03.11 3
TypeScript团队协作消息管理交流协作
Mattermost MCP Server 是一个用于与 Mattermost 工作区交互的 MCP 服务器,支持 Claude 和其他 MCP 客户端。它提供了丰富的工具集,用于监控频道、管理消息、与用户互动以及运行自定义监控任务。
View on GitHub

Overview

基本能力

产品定位

Mattermost MCP Server 是一个中间件服务,旨在通过 MCP 协议与 Mattermost 工作区进行交互,为自动化工具和客户端提供丰富的 API 功能。

核心功能

  1. 主题监控系统
  2. 监控指定频道中感兴趣的主题
  3. 可配置的监控计划(使用 cron 语法)
  4. 发现相关主题时发送通知
  5. 在指定频道中提及用户

  6. 频道工具

  7. 列出工作区中的公共频道
  8. 获取频道历史消息

  9. 消息工具

  10. 发布新消息到频道
  11. 回复特定消息线程
  12. 添加表情反应
  13. 获取线程回复

  14. 用户工具

  15. 获取工作区用户列表
  16. 获取用户详细资料

  17. 监控工具

  18. 立即触发监控过程

适用场景

  • 自动化监控 Mattermost 频道中的特定话题
  • 批量管理 Mattermost 消息和频道
  • 集成 Mattermost 到自动化工作流中
  • 开发基于 Mattermost 的机器人应用

工具列表

  1. mattermost_list_channels:列出工作区中的公共频道
  2. mattermost_get_channel_history:获取频道的最近消息
  3. mattermost_post_message:发布新消息到频道
  4. mattermost_reply_to_thread:回复特定消息线程
  5. mattermost_add_reaction:添加表情反应到消息
  6. mattermost_get_thread_replies:获取线程中的所有回复
  7. mattermost_get_users:获取工作区用户列表
  8. mattermost_get_user_profile:获取用户详细资料
  9. mattermost_run_monitoring:立即触发监控过程

常见问题解答

  • 权限问题:确保个人访问令牌具有必要权限
  • 配置问题:检查 Mattermost URL 和团队 ID 是否正确
  • 监控不工作:检查 config.local.json 中监控是否启用

使用教程

使用依赖

  1. 确保已安装 Node.js 和 npm
  2. 克隆仓库:
git clone https://github.com/yourusername/mattermost-mcp.git
cd mattermost-mcp

安装教程

  1. 安装依赖:
npm install
  1. 配置服务器:
  2. 创建 config.local.json 文件并填写 Mattermost 凭证

  3. 构建服务器:

npm run build
  1. 运行服务器:
npm start

调试方式

  1. 手动触发监控:
./run-monitoring-http.sh
  1. 查看频道消息:
node view-channel-messages.js <channel-name> [count]
  1. 分析频道统计:
node analyze-channel.js <channel-name> [count]
  1. 获取最后消息:
node get-last-message.js <channel-name>

许可证

该项目遵循 MIT 开源许可条款。