mlytics-bulldozer-mcp-server

Mlytics CDN MCP Server

A Model Context Protocol (MCP) server implementation for managing Mlytics CDN sites and DNS records.

Overview

This MCP server provides a set of tools for interacting with the Mlytics API, allowing you to:

• Create and manage CDN sites
• Check site status
• Add and list DNS records
• Update domain settings
• List available CDN providers

The server implements the Model Context Protocol, making it compatible with MCP clients and AI assistants that support the protocol.

Installation

Prerequisites

• Node.js 18.0 or higher
• npm or yarn package manager

Setup

1. Clone the repository:

git clone https://github.com/mlytics/mlytics-bulldozer-mcp-server.git
cd mlytics-bulldozer-mcp-server

2. Install dependencies:

npm install

3. Create a credentials file:

Create a file named cred in the project root directory and add your Mlytics API key:

//mlytics apikey
your-api-key-here

Usage

Start the MCP server:

node mcp-server.js

The server will start and listen for MCP requests on stdin/stdout.

Available Tools

The MCP server provides the following tools:

• automated-login: Log in to Mlytics Portal using headless browser and extract JWT token
• show-credit-info: Display current credit usage information for the authenticated user
• create-cdn-site: Create a new CDN site
• check-site-status: Check the status of a domain
• list-dns-records: List all DNS records for a site
• add-dns-record: Add a new DNS record to a site
• update-domain-settings: Update settings for a domain
• list-cdn-providers: List all available CDN providers
• list-sites: List all CDN sites
• query-cdn-edge-report: Query CDN edge performance reports for a domain
• get-historical-reports: Retrieve historical usage data for DNS queries across specified time periods
• query-guide: Query information from the Guide.md documentation with customizable output format
• capacity-forecast: Generate capacity planning forecasts with historical analysis, projections, and recommendations

For detailed information about each tool and how to use them, please refer to the file.

Authentication Methods

The MCP server supports two authentication methods:

1. JWT Token via Automated Login (Recommended): Use the automated-login tool to log in to the Mlytics Portal via a headless browser. This extracts and stores a JWT token that will be used for subsequent API calls.

   {
     "email": "your-email@example.com",
     "password": "your-password"
   }
   

   After successful login, tools like show-credit-info will automatically use the stored JWT token.

2. API Key (Legacy):

   • From the credentials file: By default, the server reads the API key from the cred file in the project directory.
   • Provided directly to tools: You can provide an API key directly when calling a tool by including the apiKey parameter.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Additional Resources

• Mlytics API Documentation
• Model Context Protocol Specification

Output Format Options in Claude

When using Claude with the MCP server, you can specify different output formats for certain tools (like the query-guide tool). Similarly, Claude itself supports different rendering options when used through various interfaces:

Formatting Options in Claude CLI

When using the Claude CLI, you can control the appearance of Claude's responses:

1. Default Terminal Output: Standard text output with basic formatting.

2. Markdown Rendering: Most Claude CLI implementations render markdown, allowing for:

   • Headers (# for h1, ## for h2, etc.)
   • Lists (bulleted and numbered)
   • Code blocks with syntax highlighting
   • Tables
   • Bold and italic text

3. Plain Text: Using the --no-markdown flag to disable markdown rendering.

4. HTML Output: Some Claude CLI implementations can output HTML that can be redirected to a file.

Using the query-guide Tool

The query-guide tool mirrors this functionality by allowing you to specify the following formats:

• text: Plain text with minimal formatting
• markdown: Markdown-formatted content
• html: HTML-formatted content for web display
• json: Structured data in JSON format

Example:

{
  "section": "Authentication Methods",
  "format": "markdown"
}

This flexibility allows you to get information in the most useful format for your specific use case.