AI Image Generation
chenyeju295LABSCO SUMMARY
One template, three named layers — useful if that shape matches yours.
This is narrower than it first looks: the parameters are bound to specific layer names, so it renders one kind of composition rather than any Templated.io template. Read as a working example of an mcp-framework tool that calls a real API, it is a reasonable place to start; read as a general image service, it will not fit.
What it is
A small stdio server built on mcp-framework that exposes one image-generation tool backed by the Templated.io API. You give it a template ID, two image URLs and a line of text; Templated.io renders the composition and returns the image. The repository doubles as a starting point for writing your own tools — it ships an example tool alongside the image one.
What you get
- A Templated Image Generator tool that renders one of your Templated.io templates
templateIdpicks the template;buildTextsets the text layerphotoBgImageUrlandbgYellowImageUrlfill the two image layers by URL- The layer names are fixed — the tool targets the "photo-bg", "bg-yellow" and "build" layers, so your template needs those
- A CLI (
mcp add tool) for adding further tools to the same server
Requirements
A Templated.io API key, passed as TEMPLATED_API_KEY in your client config. Build from source with npm install then npm run build, and point your client at node with the path to dist/index.js. The package is mcp-templateio, version 0.0.1.
Setup effort
Build from source
USE CASES
01
Producing a social image from a headline
Pass the text and the two image URLs and get the rendered composition back in the conversation.
02
Batching variations of one design
Keep the template fixed and vary the text and background URLs across calls.
03
Starting your own mcp-framework server
Use the shipped tool as the reference implementation and add more with the CLI generator.
BEFORE YOU INSTALL
What to know first
Requires
TEMPLATED_API_KEY in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
TERMINAL
git clone https://github.com/Lucker631/mcp-templateio
cd mcp-templateioInstall dependencies
TERMINAL
npm installBuild the project
TERMINAL
npm run buildMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"mcp-templateio": {
"command": "node",
"args": [
"<YOUR_PATH_TO_MCP_TEMPLATEIO>/dist/index.js"
],
"env": {
"TEMPLATED_API_KEY": "<YOUR_TEMPLATED_API_KEY>"
}
}
}
}<YOUR_TEMPLATED_API_KEY> is your Templated.io API key — get one at https://app.templated.io/api-integration.
