Mattermost MCP

🚀 Mattermost 機器人控制器協議（MCP）服務器

Mattermost 機器人控制器協議（MCP）服務器為 Mattermost 系統提供了強大的機器人控制功能，可幫助用戶更高效地管理和監控 Mattermost 平臺，提升工作效率和管理便捷性。

🚀 快速開始

若你想快速搭建並使用 Mattermost 機器人控制器協議（MCP）服務器，可按照以下步驟操作。

📦 安裝指南

安裝步驟

1. 下載代碼倉庫

   git clone https://github.com/mattermost/mattermost-mcp.git
   cd mattermost-mcp
   

2. 安裝依賴項

   npm install
   

3. 構建項目

   npm run build
   

配置說明

創建一個 config.json 文件，內容如下：

{
  "mattermostUrl": "https://your-mattermost-instance.com",
  "teamId": "your-team-id",
  "port": 3456,
  "webRoot": "/path/to/webroot"
}

💻 使用示例

基礎用法

啟動服務器

在項目根目錄運行：

node build/index.js

配置示例

示例1：基本配置

將以下內容添加到 config.json：

{
  "mattermostUrl": "https://my-mattermost-server.com",
  "teamId": "T1234567890"
}

示例2：完整配置

{
  "mattermostUrl": "https://my-mattermost-server.com",
  "teamId": "T1234567890",
  "port": 3456,
  "webRoot": "/var/www/mattermost-web"
}

高級用法

使用Claude Desktop

在 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "mattermost": {
      "command": "node",
      "args": [
        "/path/to/mattermost-mcp/build/index.js"
      ]
    }
  }
}

📚 詳細文檔

故障排除

常見問題

1. 權限錯誤：
   • 確認個人訪問令牌有正確的權限。
   • 確保令牌正確配置在 config.json 中。
   • 驗證Mattermost URL和團隊ID是否準確。
2. 網絡問題：
   • 檢查網絡連接，確保可以訪問Mattermost服務器。
   • 查看瀏覽器開發者工具中的控制檯錯誤信息。

HTTP端點

執行監控

通過以下URL觸發監控流程：

curl http://localhost:3456/run-monitoring

查詢狀態

獲取服務器和監控狀態信息：

curl http://localhost:3456/status

工具腳本

run-monitoring-http.sh

使用此腳本通過HTTP端點觸發監控：

./run-monitoring-http.sh

特點：

• 不會重啟服務器。
• 與計劃任務無衝突。
• 支持從任何終端運行。

查看頻道消息

顯示指定頻道的最新消息：

node view-channel-messages.js <channel-name>
node view-channel-messages.js <channel-name> <message-count>

示例：

node view-channel-messages.js general 10

分析頻道消息

提供頻道消息的詳細統計信息：

node analyze-channel.js <channel-name>
node analyze-channel.js <channel-name> <message-count>

示例：

node analyze-channel.js announcements

獲取幫助

顯示可用命令和用法說明：

node utils/help.js

📄 許可證

本項目遵循MIT許可證。