Traq

🚀 mcp-traQ

An MCP protocol server implemented with traQ as the data source. It fetches message, channel, and user information from LLM and makes it accessible.

🚀 Quick Start

This guide will walk you through the installation and configuration process of mcp-traQ.

📦 Installation

Download the binary file that matches your operating system and CPU architecture from the Releases. Then, grant it execution permissions and place it in a directory within your PATH.

💻 Usage Examples

Basic Usage

1. Create a traQ Bot

   • For traP members, create a bot from the Bot Console.
   • For non-traP users, use the POST /api/v3/bots API to create a bot.

2. Configure the MCP Server

   • Set the environment variable to the access token of the bot created in step 1.
   • If you're using a server other than traP, you also need to set the baseURL.
   • Here is an example of the settings in Claude Desktop:

{
    "mcpServers": {
        "slack": {
            "command": "mcp-traQ",
            "args": ["bot"],
            "env": {
                "MCP_TRAQ_BOT_TOKEN": "<Bot Access Token>",
                "MCP_TRAQ_BASE_URL": "<Base URL of traQ (not required if using the traP server)>"
            }
        }
    }
}

✨ Features

Currently, the following information retrieval functions are supported:

• Message Search
  • Retrieve the following details for each message:
    • Message content
    • Sender
    • Sending date and time
    • Attached stickers
  • Supports message search similar to that on traQ.
• Channel Search
• User Information Retrieval
• Sticker List Retrieval
• Pinned Message Retrieval

📄 License

This project is licensed under the MIT License.