Mattermost

mm-mcp

用于 Mattermost 的 MCP 服务。它让 AI Agent 读取和搜索你的 Mattermost；在你允许后，还能以你的身份或机器人身份发布消息和回复。

mm-mcp 是一个独立项目，与 Mattermost, Inc. 无关联，未获其认可或支持；Mattermost 是 Mattermost, Inc. 的商标。

这些工具可读取频道、话题串、未读帖子、提及和文件，搜索帖子、文件、人员和频道；在你允许写入后，还可发布、回复、编辑、添加回应、置顶、提议发布帖子、加入、离开和创建频道，以及设置你的状态。只要某个读取工具需要 ID，粘贴来自 Mattermost 的链接即可；每条答复都会为其中提到的每个帖子、频道和团队添加链接，并说明写入操作对其他人显示的地址；附件、附件预览、个人资料图片和自定义表情符号也都是客户端可以读取的 MCP 资源。工具页面列出了所有工具。在可呈现 MCP Apps 视图的客户端中，话题串、你的未读内容，或 Agent 创建或提议的帖子，都可以像 Mattermost 中那样显示在聊天里；更多视图正在规划中，问题列表就是规划内容。

在可显示视图的 AI 应用中，你可以看到 Agent 起草、等待你发布、修改或丢弃的回复，以及你要求查看的话题串（在线试用）：

这样设计的原因

• 除非你另行允许，否则只能读取。 在 MM_MCP_ALLOW_WRITES 为 true 之前，不会提供发布或更改内容的工具。之后，每次调用仍由 MCP 客户端自行审批；mm-mcp 会在执行前核查每项更改对其他人显示的内容：帖子或编辑会触达多少人、帖子会通知多少人、编辑会替换的文本、删除会移除的内容，以及内容发布到的地址。默认情况下，每条帖子和编辑都会标记为由 AI 撰写。设置 MM_MCP_ELICITATION_OPT_IN=true 后，mm-mcp 也会向你征求确认，但前提是客户端会显示其问题。
• 使用你的令牌、机器人的令牌或你自己的登录。 可以使用个人访问令牌、机器人令牌，或通过 mm-mcp login 使用你自己的登录方式（包括单点登录）；凭据保存在系统的凭据存储中，适用于已关闭个人访问令牌的服务器。
• 使用 Mattermost 自己的客户端。 请求和答复使用服务器自带的 Go 客户端和类型，而不是手工编写的 API 描述。
• 测试所有受支持的版本。 每次更改时，都会针对真实的 Mattermost Team Edition 运行所有工具，测试扩展支持版本和最新版本；此外，每周还会测试两者之间的所有版本。
• stdio 和 Streamable HTTP。 客户端可以将其作为本地进程启动，也可以让它在环回地址上提供 Streamable HTTP 服务。

快速开始

使用 brew install vriesdemichael/tap/mm-mcp、winget install vriesdemichael.mm-mcp 或 scoop install vriesdemichael/mm-mcp 安装 mm-mcp（使用 Scoop 前需运行 scoop bucket add vriesdemichael https://github.com/vriesdemichael/scoop），也可以从最新版本下载适用于你设备的二进制文件。然后在 Mattermost 的 个人资料 → 安全 → 个人访问令牌 中获取个人访问令牌，并使用 mm-mcp login --with paste --url https://chat.example.com 将其保存在系统的凭据存储中，不要放进客户端配置。如果这类令牌已被禁用，请改为使用 mm-mcp login --url https://chat.example.com 登录一次。

{
  "mcpServers": {
    "mattermost": {
      "command": "mm-mcp",
      "args": ["serve"],
      "env": {
        "MM_URL": "https://chat.example.com"
      }
    }
  }
}

或者，如果使用 Claude Code，可以安装插件。插件会询问服务器地址和令牌；运行 mm-mcp login 后，令牌可以留空：

/plugin marketplace add vriesdemichael/mm-mcp
/plugin install mm-mcp@mm-mcp

也可以只安装服务端：

claude mcp add mattermost --scope user --env MM_URL=https://chat.example.com -- mm-mcp serve

Claude Desktop 用户也可以从最新版本中打开适用于自己设备的 .mcpb 安装包。

如果无法正常工作，mm-mcp doctor --url https://chat.example.com 会检查配置、已保存的登录信息、与服务器的连接以及凭据，并指出需要修复的问题；在 MCP 客户端中，diagnose 工具也会使用客户端自身的配置执行相同检查。

文档介绍了所有设置、工具和支持的 Mattermost 版本。

贡献

请参阅 CONTRIBUTING.md。有关本项目构建方式的设计决策，请参阅 docs/site/adr。

许可证

Apache-2.0