Overview
What is Gaia MCP Server?
Gaia MCP Server is a deprecated TypeScript implementation of an MCP (Model Context Protocol) server for ProtoGaia. It provides a standardized way for LLMs to communicate with external AI image generation and manipulation tools. The project is no longer actively maintained; users are advised to use the new Go implementation.
How to use Gaia MCP Server?
Run directly via npx @ather-mcp/gaia-mcp-server sse or npx @ather-mcp/gaia-mcp-server stdio --api-key=YOUR_API_KEY. Alternatively, install globally with npm install -g @ather-mcp/gaia-mcp-server and then use gaia-mcp-server commands. For Claude Desktop integration, add the appropriate JSON configuration to Claude’s MCP settings and provide a valid Gaia API key.
Key features of Gaia MCP Server
- Supports stdio and SSE communication methods.
- Integrates with Claude Desktop for in-conversation image generation.
- Provides six image tools: upload-image, create-style, generate-image, remix, face-enhancer, upscaler.
- Runs without installation via npx.
- Includes health check endpoint at
/health. - Deprecated in favor of a Go implementation.
Use cases of Gaia MCP Server
- Generate images from text prompts inside LLM conversations (e.g., Claude Desktop).
- Upload existing images to the Gaia platform.
- Create and apply styles from reference images.
- Enhance faces and upscale image resolution.
- Remix existing images to create variations.
FAQ from Gaia MCP Server
Is Gaia MCP Server still maintained?
No. This repository is deprecated and no longer actively maintained. Use the Go implementation at github.com/SipherAGI/gaia-mcp-go instead.
How do I get a Gaia API key?
Log in to protogaia.com, go to account settings, navigate to the “Security” section, and create a new API key.
What runtime or dependencies are required?
Node.js is required. The server can be run via npx (no installation) or installed globally with npm. It uses the @modelcontextprotocol/sdk package.
Where are images generated and stored?
Image generation requires GAIA credits, which can be purchased on the Gaia platform. Images are processed via the Gaia API; the server itself does not store images locally.
What transport methods does the server support?
The server supports stdio (standard input/output) and SSE (Server-Sent Events over HTTP). In SSE mode, endpoints are /sse, /messages, /health, and /.
