Taikun MCP Server

A Model Context Protocol (MCP) server that provides tools for managing Taikun Cloud resources including projects, virtual clusters, catalogs, and applications.

Installation

Option 1: Download Pre-built Binaries (Recommended)

Download the latest release for your platform from the releases page.

Linux (x86_64)

curl -L https://github.com/itera-io/taikun-mcp/releases/latest/download/taikun-mcp_Linux_x86_64.tar.gz | tar xz
sudo mv taikun-mcp /usr/local/bin/

macOS (Intel)

curl -L https://github.com/itera-io/taikun-mcp/releases/latest/download/taikun-mcp_Darwin_x86_64.tar.gz | tar xz
sudo mv taikun-mcp /usr/local/bin/

macOS (Apple Silicon)

curl -L https://github.com/itera-io/taikun-mcp/releases/latest/download/taikun-mcp_Darwin_arm64.tar.gz | tar xz
sudo mv taikun-mcp /usr/local/bin/

Windows (PowerShell)

Invoke-WebRequest -Uri "https://github.com/itera-io/taikun-mcp/releases/latest/download/taikun-mcp_Windows_x86_64.zip" -OutFile "taikun-mcp.zip"
Expand-Archive -Path "taikun-mcp.zip" -DestinationPath .
# Move taikun-mcp.exe to your PATH

Option 2: Build from Source

Prerequisites

• Go 1.24 or later
• Taikun Cloud account with API access

git clone https://github.com/itera-io/taikun-mcp
cd taikun-mcp
go build -o taikun-mcp

Option 3: Using Go Install

go install github.com/itera-io/taikun-mcp@latest

Configuration

The server supports multiple authentication methods with Taikun API. Choose one of the following options:

Option 1: Access Key/Secret Key Authentication (Recommended)

export TAIKUN_ACCESS_KEY="your-access-key"
export TAIKUN_SECRET_KEY="your-secret-key"
export TAIKUN_AUTH_MODE="token"  # Optional, defaults to "token"
export TAIKUN_API_HOST="api.taikun.cloud"  # Optional, defaults to api.taikun.cloud

Option 2: Email/Password Authentication

export TAIKUN_EMAIL="your-email@example.com"
export TAIKUN_PASSWORD="your-password"
export TAIKUN_API_HOST="api.taikun.cloud"  # Optional, defaults to api.taikun.cloud

Environment File

You can also create a .env file with your preferred authentication method:

For Access Key/Secret Key:

TAIKUN_ACCESS_KEY=your-access-key
TAIKUN_SECRET_KEY=your-secret-key
TAIKUN_AUTH_MODE=token
TAIKUN_API_HOST=api.taikun.cloud

For Email/Password:

TAIKUN_EMAIL=your-email@example.com
TAIKUN_PASSWORD=your-password
TAIKUN_API_HOST=api.taikun.cloud

Usage

Starting the Server

./taikun-mcp

The server will start and listen for MCP requests via stdio transport.

Connecting from Claude Desktop

Add this configuration to your Claude Desktop config using your preferred authentication method:

For Access Key/Secret Key Authentication:

{
  "mcpServers": {
    "taikun": {
      "command": "/path/to/taikun-mcp",
      "env": {
        "TAIKUN_ACCESS_KEY": "your-access-key",
        "TAIKUN_SECRET_KEY": "your-secret-key",
        "TAIKUN_AUTH_MODE": "token"
      }
    }
  }
}

For Email/Password Authentication:

{
  "mcpServers": {
    "taikun": {
      "command": "/path/to/taikun-mcp",
      "env": {
        "TAIKUN_EMAIL": "your-email@example.com",
        "TAIKUN_PASSWORD": "your-password"
      }
    }
  }
}

Support

For issues and questions:

• Create an issue in this repository
• Check the Taikun documentation
• Review the MCP specification