Mattermost MCP Host
2025.04.08
6
Python团队协作智能对话工具集成交流协作
Mattermost MCP Host 是一个与 Mattermost 集成的服务，通过连接 Model Context Protocol (MCP) 服务器，利用基于 LangGraph 的 AI 代理，为用户提供智能交互界面，并直接在 Mattermost 中执行工具。
View on GitHub
Overview
基本能力
产品定位
Mattermost MCP Host 是一个智能集成服务，旨在通过 AI 代理和 MCP 服务器增强 Mattermost 的功能，提供更高效的团队协作和自动化工具调用。
核心功能
- Langgraph Agent 集成：使用 LangGraph 代理理解用户请求并协调响应。
- MCP 服务器集成：连接到多个 MCP 服务器，动态加载工具。
- 动态工具加载：自动发现 MCP 服务器上的工具，并将其转换为 LangChain 结构化工具。
- 线程感知对话：在 Mattermost 线程中维护对话上下文，确保交互连贯。
- 智能工具使用：AI 代理可以决定何时使用工具（包括链式调用）来满足用户请求。
- MCP 能力发现：允许用户通过命令列出可用的服务器、工具、资源和提示。
- 直接命令接口：使用命令前缀（默认
#）直接与 MCP 服务器交互。
适用场景
- 团队协作：在 Mattermost 中通过 AI 代理自动化任务，如搜索、创建问题等。
- 工具集成：动态调用 MCP 服务器上的工具，扩展 Mattermost 的功能。
- 智能对话：通过线程感知的对话上下文，提供连贯的交互体验。
使用教程
使用依赖
- Python 3.13.1+：确保系统已安装 Python 3.13.1 或更高版本。
- uv 包管理器：推荐使用 uv 进行依赖管理。
- Mattermost 服务器实例：需要一个运行的 Mattermost 服务器实例。
- Mattermost Bot 账户：创建一个 Bot 账户并获取 API 令牌。
- LLM API 访问：需要访问 LLM API（如 Azure OpenAI）。
安装教程
- 克隆仓库：
bash git clone <repository-url> cd mattermost-mcp-host - 安装依赖： ```bash # 激活虚拟环境 source .venv/bin/activate
# 使用 uv 安装依赖 uv sync
# 安装开发依赖（可选）
uv sync --dev --all-extras
3. **配置环境变量**：复制 `.env.example` 并填写相关配置。
4. **配置 MCP 服务器**：编辑 `src/mattermost_mcp_host/mcp-servers.json` 定义要连接的 MCP 服务器。
5. **启动服务**：bash
mattermost-mcp-host
```
调试方式
- 检查连接：确保 Mattermost 服务器运行正常，Bot 令牌权限正确。
- 验证 API 密钥：检查 LLM API 密钥是否正确配置。
- 查看日志：检查服务日志以排查 MCP 服务器连接问题。
常见问题解答
- 连接问题：
- 确保 Mattermost 服务器运行正常。
- 检查 Bot 令牌权限是否正确。
- 确认团队和频道名称是否正确。
- AI 提供商问题：
- 验证 API 密钥是否正确。
- 检查 API 配额和限制。
- 确保网络可以访问 API 端点。
- MCP 服务器问题：
- 检查服务器日志。
- 验证服务器配置是否正确。
- 确保所有依赖已安装且环境变量已定义。