mcp-image-server-BKP by ricardopera - MCP Server

MCP Image Server

Descrição

O MCP Image Server é uma aplicação projetada para gerar imagens e ícones personalizados. Ele permite que os usuários criem imagens a partir de parâmetros fornecidos e gerem ícones com base em templates e especificações. A aplicação é integrada com serviços de inteligência artificial para melhorar a qualidade das imagens geradas.

Estrutura do Projeto

O projeto é organizado da seguinte forma:

src/: Contém o código-fonte da aplicação.
- server.ts: Ponto de entrada da aplicação, configura o servidor e define as rotas.
- tools/: Contém ferramentas para geração de imagens e ícones.
  - image-generator.ts: Classe para geração de imagens.
  - icon-generator.ts: Classe para criação de ícones personalizados.
  - index.ts: Exporta as classes de ferramentas.
- services/: Contém serviços que suportam a geração de imagens e ícones.
  - ai-image-service.ts: Integra serviços de IA para melhorar a geração de imagens.
  - icon-library-service.ts: Gerencia uma biblioteca de ícones pré-existentes.
  - storage-service.ts: Lida com o armazenamento de imagens e ícones.
- utils/: Contém funções utilitárias.
  - image-utils.ts: Funções para manipulação de imagens.
  - validation.ts: Funções para validação de entradas do usuário.
- types/: Contém interfaces e tipos utilizados no projeto.
config/: Contém configurações padrão do servidor.
- default.json: Configurações como portas e caminhos de armazenamento.
assets/: Contém templates de imagens e ícones.
generated-assets/: (IGNORADO NO GIT) Imagens e ícones gerados automaticamente
.env: (IGNORADO NO GIT) Variáveis de ambiente, incluindo OPENAI_API_KEY
package.json: Configuração do npm, listando dependências e scripts.
tsconfig.json: Configuração do TypeScript.

Novidades (Jul/2025)

Geração de ícones agora utiliza IA (OpenAI DALL-E) e não apenas SVGs simples
Corrigido bug de sintaxe no serviço de ícones
Testes automatizados e scripts de integração para endpoints REST
.env e generated-assets/ agora são ignorados pelo Git para segurança e organização
Adicionado endpoint .well-known/ai-plugin.json e /openapi.json para integração automática com agentes MCP/Copilot
Validação de entradas e saídas dos endpoints para segurança e conformidade MCP

## Instalação Para instalar o projeto, siga os passos abaixo:

Clone o repositório:
```
git clone <URL_DO_REPOSITORIO>
```
Navegue até o diretório do projeto:
```
cd mcp-image-server
```
Instale as dependências:
```
npm install
```

Uso

Para iniciar o servidor:

npm run build
npm start

Ou para desenvolvimento:

npm run dev

Integração automática com Copilot/MCP

O servidor expõe endpoints .well-known/ai-plugin.json e /openapi.json para descoberta automática por agentes MCP e Copilot.
Basta apontar o agente para http://localhost:3000/.well-known/ai-plugin.json para integração.

Após iniciar, utilize as rotas /generate-image e /generate-icon para gerar imagens e ícones via IA. Veja exemplos em test-generate-image.js e test-generate-icon.js.

Exemplos de Integração

Exemplo de imagem gerada

Exemplo de ícone gerado

Scripts de exemplo para testar a API:

test-generate-image.js: Gera uma imagem via endpoint REST
test-generate-icon.js: Gera ícones reais via IA (OpenAI)

Segurança

O arquivo .env e a pasta generated-assets/ agora estão corretamente ignorados pelo Git.
Entradas dos endpoints são validadas para evitar uso indevido (conforme recomendações MCP).
Recomenda-se não expor o servidor publicamente sem autenticação.
Ferramentas e endpoints documentados para facilitar auditoria e integração segura.

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou pull requests para melhorias e correções.

Licença

Este projeto está licenciado sob a MIT License. Veja o arquivo LICENSE para mais detalhes.