dooray

This Dooray MCP Server provides a set of MCP tools to manage Dooray content via a standardized MCP protocol. It exposes wiki operations (listing, reading, creating, updating pages and their references), project operations (listing, creating, updating posts and their workflow), and post comment operations (create, read, update, delete). You interact with the server by sending MCP commands in JSON, for example naming the tool you want to execute and providing the required arguments. Typical usage involves starting the server (here via Docker) with the necessary environment variables for the Dooray API and base URL, then invoking the available tools through MCP requests. Logs are emitted to standard error, so monitor stderr for runtime output while keeping stdout clean for protocol messages.

Prerequisites:

• Docker installed on your machine (recommended for ease of use).
• Optional: Java/Gradle if you prefer building from source instead of using the Docker image.

Installation steps (Docker):

1. Ensure Docker is running.

2. Run the MCP server with required environment variables:

   docker run -i
   -e DOORAY_API_KEY="your_api_key"
   -e DOORAY_BASE_URL="https://api.dooray.com"
   -e DOORAY_LOG_LEVEL="WARN"
   -e DOORAY_HTTP_LOG_LEVEL="WARN"
   bifos/dooray-mcp:latest

Installation steps (from source, if you prefer building locally):

1. Ensure Java (JDK 11+) and Gradle are installed.

2. Clone the repository and navigate into it.

3. Build the project:

   ./gradlew clean shadowJar

4. Run locally (requires the environment file or variables):

   java -jar build/libs/dooray-mcp-server-0.2.1-all.jar

Note: The README indicates a Docker image is provided for distribution; using Docker is the recommended path for ease of setup.

Notes and tips:

• The MCP server communicates via stdin/stdout, but all logs are written to stderr. Increasing log levels will not affect protocol traffic, but may impact performance due to higher I/O.
• The provided image bifos/dooray-mcp:latest supports multi-platform Docker builds; ARM64 builds are temporarily disabled due to Gradle dependency issues in certain environments.
• Required environment variables: DOORAY_API_KEY and DOORAY_BASE_URL. Optional logging controls: DOORAY_LOG_LEVEL and DOORAY_HTTP_LOG_LEVEL (default WARN).
• Tools exposed include 19 commands across wiki, project, and post-comment domains. You can reproduce examples from the README to ensure correct request formats.
• If you run into network or API issues, verify the DOORAY_BASE_URL is reachable from the host and the API key has the required permissions for the operations you perform.