mcp-traQ

mcp-traQ

site icon
2025.03.17 1
TypeScript团队协作平台集成消息处理交流协作
mcp-traQ 是一个基于 traQ 数据源的 MCP 协议服务器实现,允许 LLM 获取消息、频道、用户信息等数据。
View on GitHub

Overview

基本能力

产品定位

mcp-traQ 是一个基于 traQ 数据源的 MCP 协议服务器实现,主要用于从 traQ 平台获取消息、频道、用户信息等数据,供 LLM 或其他应用程序使用。

核心功能

  • 消息搜索
  • 获取消息内容、发送者、发送时间、附加的贴纸等信息
  • 支持与 traQ 平台几乎相同的搜索功能
  • 频道搜索
  • 用户信息获取
  • 贴纸列表获取
  • 置顶消息获取

适用场景

  • 团队协作平台的数据集成
  • LLM 或其他应用程序需要访问 traQ 数据时
  • 自动化消息处理和分析

工具列表

  • mcp-traQ 二进制文件:用于运行 MCP 协议服务器

常见问题解答

使用教程

使用依赖

无特殊依赖,只需下载对应平台的二进制文件即可。

安装教程

  1. Releases 下载适合您操作系统和 CPU 架构的二进制文件
  2. 为文件添加执行权限
  3. 将文件放置在 PATH 环境变量包含的目录中

调试方式

  1. 创建 traQ Bot
  2. traP 成员可以通过 Bot Console 创建 Bot
  3. 非 traP 成员可以使用 POST /api/v3/bots API 创建 Bot
  4. 配置 MCP 服务器
  5. 设置环境变量 MCP_TRAQ_BOT_TOKEN 为 Bot 的 Access Token
  6. 如果使用非 traP 服务器,还需设置 MCP_TRAQ_BASE_URL 环境变量

示例配置(Claude Desktop):

{
  "mcpServers": {
    "slack": {
      "command": "mcp-traQ",
      "args": ["bot"],
      "env": {
        "MCP_TRAQ_BOT_TOKEN": "<Bot的Access Token>",
        "MCP_TRAQ_BASE_URL": "<traQ的基URL(traP的服务器的情况下不需要)>"
      }
    }
  }
}

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。