Model Context Protocol
Pollinations Multimodal MCP Server is designed to enable AI assistants to generate media content such as images, text, and audio using the Pollinations APIs. It is characterized by a simple, lightweight design with stdio transport for integration, and is compatible with multiple models for content generation.
Pollinations Multimodal MCP Server
A Model Context Protocol (MCP) server for the Pollinations APIs that enables AI assistants like Claude to generate images, text, and audio directly. This server follows the "thin proxy" design principle, focusing on minimal data transformation and direct communication through stdio.
Features
- Generate image URLs from text prompts
- Generate actual images and return them as base64-encoded data
- Generate text responses from text prompts
- Generate audio (text-to-speech) from text prompts
- List available image and text generation models
- STDIO transport for easy integration with MCP clients
- Simple and lightweight
- Compatible with the Model Context Protocol (MCP)
System Requirements
- Node.js: Version 14.0.0 or higher
- For best performance, we recommend Node.js 16.0.0 or higher
- Node.js versions below 16 use an AbortController polyfill
Quick Start
The easiest way to use the MCP server:
# Run directly with npx (no installation required)
npx @pollinations/model-context-protocol
If you prefer to install it globally:
# Install globally
npm install -g @pollinations/model-context-protocol
# Run the server
pollinations-mcp
Transport
The MCP server exclusively uses STDIO transport, which is ideal for local integrations and command-line tools:
# Run with STDIO transport
npx @pollinations/model-context-protocol
For MCP clients, connect using:
npx supergateway --stdio -- pollinations-mcp
Claude Desktop Integration
To install the MCP server in Claude Desktop:
# Run the installation script
npx @pollinations/model-context-protocol install-claude-mcp
This script will automatically:
- Find the Claude Desktop configuration file for your OS
- Add the Pollinations MCP server to the configuration
- Configure it to use npx for easy updates
After installation, restart Claude Desktop and you can use commands like:
Generate an image of a sunset over the ocean using the Pollinations API.
Alternative MCP Implementations
- MCPollinations: A community-maintained alternative MCP server supporting similar capabilities. Available at GitHub and NPM.
Troubleshooting
"AbortController is not defined" Error
If you encounter this error when running the MCP server:
ReferenceError: AbortController is not defined
This is usually caused by running on an older version of Node.js (below version 16.0.0). Try one of these solutions:
-
Update Node.js (recommended):
- Update to Node.js 16.0.0 or newer
-
Use our polyfill (automatic in version 1.0.6+):
- Update to the latest version of the package:
npm install -g @pollinations/model-context-protocol@latest # or run with npx npx @pollinations/model-context-protocol@latest
-
Install AbortController manually:
- If for some reason the polyfill doesn't work:
npm install node-abort-controller
Check Your Node.js Version
To check your current Node.js version:
node --version
If it shows a version lower than 16.0.0, consider upgrading for best compatibility.
Available Tools
The MCP server provides the following tools:
Content Generation
generateImageUrl
- Generates an image URL from a text promptgenerateImage
- Generates an image and returns it as base64-encoded datarespondAudio
- Generates an audio response to a text promptsayText
- Generates speech that says the provided text verbatimgenerateText
- Generates text from a prompt using text modelslistModels
- Lists available models for image or text generation
Changelog
Version 1.0.7
- Simplified architecture by removing HTTP server components
- Transitioned to stdio-only transport following MCP best practices
- Removed authentication server (moved to separate github-app-auth service)
- Reduced dependencies for a smaller, more focused package
- Updated documentation to reflect the new architecture
Version 1.0.6
- Added compatibility with Node.js versions 14.0.0 and later
- Added AbortController polyfill for Node.js versions below 16.0.0
- Fixed "AbortController is not defined" error
- Improved error handling and reporting
- Added troubleshooting guide in README
- Enhanced documentation with system requirements and installation options
Version 1.0.5
- Initial public release
License
MIT