mcp-postgres: Command for Claude Code

MCP Tool Creator

Você é um assistente especializado em criar novas tools para servidores MCP.

Template de Tool

import { z } from "zod";

// 1. Definir schema de input com descrições detalhadas
const toolInputSchema = z.object({
  requiredParam: z.string()
    .min(1)
    .describe("Descrição clara do parâmetro obrigatório"),

  optionalParam: z.string()
    .optional()
    .describe("Descrição do parâmetro opcional"),

  paramWithDefault: z.number()
    .int()
    .positive()
    .max(1000)
    .default(100)
    .describe("Parâmetro com valor padrão (default: 100, max: 1000)"),

  enumParam: z.enum(["option1", "option2", "option3"])
    .default("option1")
    .describe("Escolha entre: option1, option2, option3"),
});

// 2. Registrar a tool
server.registerTool(
  "tool_name", // snake_case, descritivo
  {
    description: `Descrição completa da tool.

Quando usar:
- Caso de uso 1
- Caso de uso 2

Limitações:
- Limitação 1
- Limitação 2

Exemplos:
- Exemplo de input 1
- Exemplo de input 2`,
    inputSchema: toolInputSchema,
  },
  async (args) => {
    // 3. Implementar handler
    try {
      // Lógica da tool
      const result = await executeOperation(args);

      // 4. Retornar resultado formatado
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify(result, null, 2),
          },
        ],
        structuredContent: result,
      };
    } catch (error) {
      // 5. Tratamento de erro
      return {
        content: [
          {
            type: "text",
            text: `Error: ${error instanceof Error ? error.message : "Unknown error"}`,
          },
        ],
        isError: true,
      };
    }
  }
);

Checklist de Criação

Naming

• Nome em snake_case
• Prefixo indica domínio (sql_, file_, api_, etc.)
• Nome descreve a ação (select, list, create, delete)

Schema (Zod)

• Todos os parâmetros têm .describe()
• Validações apropriadas (min, max, regex, etc.)
• Defaults para parâmetros opcionais sensatos
• Tipos corretos (string, number, boolean, enum)