🤖 MCPollinations MCP Server
✅ Server Status: Running
Official Model Context Protocol server for AI image and text generation via Pollinations AI.
🛠️ Available Tools
generate_image - Generate images from text prompts
Models: flux, gptimage, playground
generate_text - Generate text using AI models
Models: openai, claude, gemini
🔗 MCP Client Setup
Server URL:
https://huggingface.co/spaces/legends810/mcp-server
📚 Integration Examples
Claude Desktop
{
"mcpServers": {
"mcpollinations": {
"command": "npx",
"args": ["mcp-remote", "https://huggingface.co/spaces/legends810/mcp-server"]
}
}
}
n8n MCP Client
URL: https://huggingface.co/spaces/legends810/mcp-server
Transport: HTTP
🚀 Quick Test
curl -X POST https://huggingface.co/spaces/legends810/mcp-server/call \\
-H "Content-Type: application/json" \\
-d '{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "generate_image",
"arguments": {"prompt": "beautiful sunset"}
},
"id": 1
}'
"""
else:
# Return MCP protocol response for clients
return jsonify(create_mcp_response(
result={
"protocolVersion": "2024-11-05",
"capabilities": {
"tools": {"listChanged": True},
"logging": {}
},
"serverInfo": SERVER_INFO
}
))
@app.route('/initialize', methods=['POST'])
def initialize():
"""MCP Initialize endpoint"""
try:
data = request.get_json()
request_id = data.get('id')
return jsonify(create_mcp_response(
id=request_id,
result={
"protocolVersion": "2024-11-05",
"capabilities": {
"tools": {"listChanged": True},
"logging": {}
},
"serverInfo": SERVER_INFO
}
))
except Exception as e:
return jsonify(create_mcp_response(
error={"code": -32603, "message": f"Internal error: {str(e)}"}
)), 500
@app.route('/tools/list', methods=['POST'])
def tools_list():
"""MCP Tools List endpoint"""
try:
data = request.get_json()
request_id = data.get('id')
return jsonify(create_mcp_response(
id=request_id,
result={"tools": MCP_TOOLS}
))
except Exception as e:
return jsonify(create_mcp_response(
error={"code": -32603, "message": f"Internal error: {str(e)}"}
)), 500
@app.route('/tools/call', methods=['POST'])
@app.route('/call', methods=['POST'])
def tools_call():
"""MCP Tools Call endpoint (Main functionality)"""
try:
data = request.get_json()
request_id = data.get('id')
params = data.get('params', {})
tool_name = params.get('name')
arguments = params.get('arguments', {})
if tool_name == 'generate_image':
result = handle_image_generation(arguments)
elif tool_name == 'generate_text':
result = handle_text_generation(arguments)
else:
return jsonify(create_mcp_response(
id=request_id,
error={"code": -32601, "message": f"Unknown tool: {tool_name}"}
)), 400
return jsonify(create_mcp_response(
id=request_id,
result=result
))
except Exception as e:
return jsonify(create_mcp_response(
error={"code": -32603, "message": f"Tool execution failed: {str(e)}"}
)), 500
def handle_image_generation(arguments):
"""Handle image generation with Pollinations API"""
prompt = arguments.get('prompt', 'beautiful landscape')
model = arguments.get('model', 'flux')
width = arguments.get('width', 1024)
height = arguments.get('height', 1024)
# Build Pollinations URL
params = []
if width != 1024:
params.append(f"width={width}")
if height != 1024:
params.append(f"height={height}")
if model != 'flux':
params.append(f"model={model}")
image_url = f"https://image.pollinations.ai/{quote(prompt)}"
if params:
image_url += "?" + "&".join(params)
return {
"content": [
{
"type": "image",
"data": image_url,
"mimeType": "image/png"
},
{
"type": "text",
"text": f"Generated image: {prompt}\nModel: {model}\nDimensions: {width}x{height}\nURL: {image_url}"
}
]
}
def handle_text_generation(arguments):
"""Handle text generation with Pollinations API"""
prompt = arguments.get('prompt', 'Hello world')
model = arguments.get('model', 'openai')
max_tokens = arguments.get('max_tokens', 1000)
# Call Pollinations text API
try:
text_url = f"https://text.pollinations.ai/{quote(prompt)}?model={model}"
response = requests.get(text_url, timeout=30)
generated_text = response.text[:max_tokens] # Limit tokens
except:
generated_text = f"Generated response for: {prompt} (using {model} model)"
return {
"content": [
{
"type": "text",
"text": generated_text
}
]
}
# Legacy endpoints for backward compatibility
@app.route('/status')
def status():
return jsonify({
"status": "running",
"server": SERVER_INFO["name"],
"version": SERVER_INFO["version"],
"mcp_protocol": "2024-11-05",
"timestamp": datetime.now().isoformat()
})
@app.route('/health')
def health():
return jsonify({"status": "healthy"})
if __name__ == '__main__':
port = int(os.environ.get('PORT', 7860))
app.run(host='0.0.0.0', port=port, debug=False, threaded=True)