🚀 mcp-traQ

mcp-traQ 是一个基于 traQ 数据源实现的 MCP 协议服务器，它能够从大语言模型（LLM）获取消息、频道和用户信息，并让这些信息变得可用。

🚀 快速开始

mcp-traQ 可帮助你从 LLM 便捷获取 traQ 相关信息，下面为你介绍详细的安装和使用方法。

📦 安装指南

从发行版下载与操作系统/CPU 架构匹配的二进制文件，赋予执行权限并将其放置在 PATH 通路上的目录中。

💻 使用示例

基础用法

1. 创建 traQ 机器人

• 对于 trap 成员，可以从Bot 控制台创建机器人。
• 对于非 trap 用户，请使用POST /api/v3/bots创建机器人。

2. 配置 MCP 服务器

• 将环境变量设置为步骤 1 中创建的机器人的访问令牌。
• 如果使用的是 traP 以外的服务器，也需要设置 baseURL。
• 在 Claude Desktop 中的设置示例：

{
  "mcpServers": {
    "slack": {
      "command": "mcp-traQ",
      "args": ["bot"],
      "env": {
        "MCP_TRAQ_BOT_TOKEN": "<机器人的访问令牌>",
        "MCP_TRAQ_BASE_URL": "<traQ 的基 URL（如果使用的是 trap 服务器，则不需要）>"
      }
    }
  }
}

✨ 主要特性

目前仅支持以下信息的获取：

• 消息搜索：获取每个消息的以下内容：
  • 消息内容
  • 发送者
  • 发送日期和时间
  • 添加的贴纸
  • 支持与 traQ 上几乎相同的消息搜索。
• 频道搜索
• 用户信息获取
• 贴纸列表获取
• 固定消息的获取

📄 许可证

本项目采用 MIT License。