TemplateIO Image Generation

Gere imagens usando a API do Templated.io. Requer uma chave de API do Templated.io.

Documentação

MCP TemplateIO - Ferramenta de Geração de Imagens

Um servidor Model Context Protocol (MCP) construído com mcp-framework que fornece uma ferramenta de geração de imagens usando Templated.io.

Visão Geral

Este template fornece um ponto de partida para construir servidores MCP com ferramentas personalizadas. Ele inclui uma ferramenta de exemplo e instruções sobre como adicionar mais ferramentas, desenvolvê-las e publicá-las no npm. Este README irá guiá-lo pelo processo de configuração, desenvolvimento e implantação do seu próprio servidor MCP.

Início Rápido

# Install dependencies
npm install

# Build the project
npm run build

Estrutura do Projeto

mcp-templateio/
├── src/
│   ├── tools/        # MCP Tools
│   │   ├── ExampleTool.ts
│   │   └── TemplatedImageTool.ts # Image generation tool
│   └── index.ts      # Server entry point
├── package.json
└── tsconfig.json

Ferramentas Disponíveis

Gerador de Imagens Templated

Esta ferramenta gera uma imagem com base em um template, dados texto e URLs de imagens, usando a API do Templated.io.

Parâmetros de Entrada:

templateId: ID do template do Templated.io a ser usado
photoBgImageUrl: URL da imagem a ser colocada na camada "photo-bg".
bgYellowImageUrl: URL da imagem a ser colocada na camada "bg-yellow".
buildText: Conteúdo de texto para a camada de texto "build".

Desenvolvimento de Ferramentas

Estrutura de exemplo de ferramenta:

import { MCPTool } from "mcp-framework";
import { z } from "zod";

interface MyToolInput {
  message: string;
}

class MyTool extends MCPTool<MyToolInput> {
  name = "my_tool";
  description = "Describes what your tool does";

  schema = {
    message: {
      type: z.string(),
      description: "Description of this input parameter",
    },
  };

  async execute(input: MyToolInput) {
    // Your tool logic here
    return `Processed: ${input.message}`;
  }
}

export default MyTool;

Adicionando Componentes

O projeto vem com uma ferramenta de exemplo em src/tools/ExampleTool.ts e o TemplatedImageTool.ts. Você pode adicionar mais ferramentas usando a CLI:

# Add a new tool
mcp add tool my-tool

# Example tools you might create:
mcp add tool data-processor
mcp add tool api-client
mcp add tool file-handler

Publicando no npm

Atualize seu package.json:
- Garanta que name seja único e siga as convenções de nomenclatura do npm
- Defina o version apropriado
- Adicione description, author, license, etc.
- Verifique se bin aponta para o arquivo de entrada correto

Compile e teste localmente:

npm run build
npm link
mcp-templateio  # Test your CLI locally

Faça login no npm (crie uma conta se necessário):
```
npm login
```
Publique seu pacote:
```
npm publish
```

Após publicar, os usuários podem adicioná-lo ao cliente desktop do Claude (leia abaixo) ou executá-lo com npx

Usando com Claude Desktop

Desenvolvimento Local

Adicione esta configuração ao arquivo de configuração do seu Claude Desktop:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-templateio": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-templateio/dist/index.js"]
    }
  }
}

Após Publicar

OBTENHA SUA CHAVE DE API AQUI: https://app.templated.io/api-integration?template=4ae9a86b-4ecd-44ee-aebd-7c5a49c16969