Mattermost MCP Server 使用说明

项目简介

Mattermost MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在将 Mattermost 平台的功能集成到 LLM 应用中。它允许 LLM 客户端通过标准化的 MCP 协议，调用 Mattermost 的各种功能，如发送消息、管理频道、搜索帖子等，从而实现 LLM 与 Mattermost 的深度集成。

主要功能点

工具 (Tools): 提供操作 Mattermost 的工具，例如 'post-message' (发送消息), 'list-channels' (列出频道), 'search-posts' (搜索帖子)。
资源 (Resources): 将 Mattermost 的实体 (如团队、频道、帖子) 暴露为资源，允许客户端读取这些信息。
Prompt 模板 (Prompts): 提供用于 Mattermost 场景的 Prompt 模板，如 'summarize-channel' (频道总结), 'analyze-discussion' (讨论分析)。

安装步骤

确保已安装 Python 3.7+ 环境。
克隆仓库 'mattermost-mcp-bridge' 到本地。
进入 'mattermost-mcp-bridge/mattermost-mcp-server/src/mattermost_mcp_server' 目录。

创建并激活 Python 虚拟环境 (可选但推荐):

python3 -m venv venv
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate  # Windows

安装 'mcp-protocol' 及依赖:

pip install mcp-protocol aiohttp pydantic

服务器配置

MCP客户端需要配置 MCP服务器的启动命令及其参数。以下是 'mattermost-mcp-server' 的配置信息示例 (JSON 格式)，用于 'mattermost-mcp-client/src/mattermost_mcp_client/mcp-servers.json' 文件中：

{
  "mattermost-mcp-server": {
    "command": "python",
    "args": ["mattermost-mcp-server/src/mattermost_mcp_server/server.py"],
    "type": "stdio"
  }
}

参数注释:
- 'server name': 'mattermost-mcp-server' - 服务器名称，用于在客户端配置中标识和引用。
- 'command': '"python"' - 启动 MCP 服务器的命令，这里使用 Python 解释器。
- 'args': '["mattermost-mcp-server/src/mattermost_mcp_server/server.py"]' - 传递给启动命令的参数，指定服务器脚本的路径。
- 'type': '"stdio"' - 指定 MCP 服务器的传输协议为标准输入/输出 (stdio)。
环境变量配置: 'mattermost-mcp-server' 需要以下环境变量进行配置 (可以在 '.env' 文件中设置):
- 'MATTERMOST_URL': Mattermost 服务器的 URL (例如: 'http://localhost').
- 'MATTERMOST_TOKEN': Mattermost Bot 用户的访问令牌。
- 'MATTERMOST_SCHEME': Mattermost 服务器的协议 (通常为 'http' 或 'https').
- 'MATTERMOST_PORT': Mattermost 服务器端口 (例如: '8065').
- 'MATTERMOST_TEAM_NAME': Mattermost 团队名称.
- 'MATTERMOST_CHANNEL_NAME': Mattermost 频道名称.
- 'MATTERMOST_CHANNEL_ID': Mattermost 频道 ID (如果未设置，服务器将尝试自动检测).

基本使用方法

启动 Mattermost MCP 服务器。
配置并启动 MCP 客户端 (例如 'mattermost-mcp-client')，确保客户端配置中包含了 'mattermost-mcp-server' 的配置信息，并且 Mattermost 相关的环境变量已正确设置。
使用 MCP 客户端向 'mattermost-mcp-server' 发送请求，例如列出工具、调用工具、读取资源、获取 Prompt 等。具体操作方式取决于 MCP 客户端的实现。例如，在 'mattermost-mcp-client' 中，可以使用 '!mcp mattermost-mcp-server tools' 命令列出 'mattermost-mcp-server' 提供的工具。

关键词