home / mcp / palettemcp mcp server

PaletteMCP MCP Server

Exposes color name lookup via MCP by converting hex colors to closest CSS color names with JSON output.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "kelvinzer0-palettemcp": {
      "command": "./palette-mcp",
      "args": [
        "server"
      ]
    }
  }
}

PaletteMCP is a command-line tool written in Go that converts a hex color code into the closest matching named CSS color and exposes this functionality as an MCP server. You can run the tool locally and access color lookup capabilities through an MCP client, enabling easy integration into automation and workflows.

How to use

To use PaletteMCP with an MCP client, start the server in stdio mode for local use and then connect your client to the running process. You can run the server in several transport modes depending on your needs.

Run the server in stdio mode (local process). This is the default and simplest way to expose color lookup as an MCP service.

Start the server with the standard command and argument set for stdio transport.

How to install

Prerequisites: you need Go installed on your system to build the server from source.

Install Go if it is not already installed.

Build the executable from the source files.

go build -o palette-mcp ./cmd/palette-mcp

Run and test locally

Run the server in stdio (local) mode using the binary you built.

Then you can look up a color by providing a hex code to the server via the MCP client or by launching the client with the server running.

Configuration and usage notes

You can run the server in HTTP or SSE modes if you prefer different transports, but HTTP/SSE require explicit port handling and transport configuration.

Additional details and examples

Example workflows include starting the server in different modes and then using an MCP client to request color information. Below are the direct command examples shown for server operation.

Configuration snippets for MCP clients

{
  "mcpServers": {
    "palette_color_info": {
      "command": "./palette-mcp",
      "args": ["server"]
    }
  }
}

Available tools

get_color_info

Retrieves information about a color given its hex code, returning the closest named CSS color along with hex and RGB values.

echo

Demonstration tool that echoes back a provided message as part of an MCP workflow.