🌀 Clarifai MCP Server (unofficial)

This hackday project provides a Model Context Protocol (MCP) server that acts as a bridge to the Clarifai API and is meant to run on user's machine (so locally). It allows MCP clients (like IDE extensions) to interact with Clarifai, such as image generation and inference, using standard MCP requests without overloading LLM context with heavy binary results.

Configuring MCP server for seamless interaction

The server is typically run automatically by the MCP client framework (e.g., via settings in VS Code). The configuration usually involves specifying the path to the built binary and any required command-line arguments, such as the Clarifai PAT. You will need Go (version 1.23 or later)

cd ~
git clone git@github.com:tot-ra/clarifai-mcp-server-local.git
cd clarifai-mcp-server-local
go mod tidy

Build the Binary: Use the go build command, targeting the main package within the cmd/server directory. Specify the output path and target architecture if needed (example for macOS ARM):

# For macOS ARM
make build

# For Linux AMD64
# GOOS=linux GOARCH=amd64 go build -o ./mcp_binary ./...

# For Windows AMD64
# GOOS=windows GOARCH=amd64 go build -o ./mcp_binary.exe ./...

This will create an executable file named mcp_binary (or mcp_binary.exe on Windows) in the project's root directory.

Example MCP settings entry (cline_mcp_settings.json), for example for Cline:

{
  "mcpServers": {
    "clarifai": {
      "command": "~/clarifai-mcp-server-local/mcp_binary",
      "args": [
        "--pat", "YOUR_CLARIFAI_PAT",
        "--output-path", "~/Desktop/",
        "--default-user-id", "your_user_id",
        "--default-app-id", "your_app_id",
      ],
    }
  }
}

Replace YOUR_CLARIFAI_PAT with your Clarifai PAT token.

Testing

Unit tests have been added for several packages. To run all tests, bypass the cache, and see verbose output (including individual test names and status):

cd clarifai-mcp-server-local
go test -v -count=1 ./...

Features

The server currently exposes the following MCP capabilities:

Tools

• upload_file: Uploads a local file to Clarifai as an input.

  • Input: filepath (required, absolute path to the local file), user_id, app_id (optional).
  • Output: Text confirmation and API response details upon successful upload.

• generate_image: Generates an image based on a text prompt using a specified or default Clarifai text-to-image model.

  • Input: text_prompt (required), model_id, user_id, app_id (optional).
  • Output: Base64 encoded image data (for small images) or a file path (for large images saved to the configured --output-path).

For example, given a user prompt, AI agent automatically can call image generation and places results on Desktop

Generate 3 cat images with Clarifai

• clarifai_image_by_path: Performs inference on a local image file using a specified or default Clarifai model.
  • Input: filepath

... View full README on GitHub