Development
Converte especificacoes OpenAPI ou Swagger em JSON/YAML em tipos TypeScript, parametros de requisicao e modelos de resposta com formato de saida e estilo de nomes configuraveis
Chame esta ferramenta a partir do seu código em três idiomas.
curl -X POST 'https://api.elysiatools.com/pt/api/tools/openapi-to-typescript-generator' \
-H 'Content-Type: application/json' \
-d '{"specInput":"openapi: 3.0.0\ninfo:\n title: User API\n version: 1.0.0\npaths:\n /users/{id}:\n get:\n operationId: getUser\n parameters:\n - in: path\n name: id\n required: true\n schema:\n type: string\n responses:\n \"200\":\n description: ok\n content:\n application/json:\n schema:\n $ref: \"#/components/schemas/User\"\ncomponents:\n schemas:\n User:\n type: object\n required: [id, name]\n properties:\n id:\n type: string\n name:\n type: string","sourceFormat":"yaml","outputFormat":"flat","namingStyle":"pascal","declarationStyle":"interface","namespaceName":"Api","includeOperationTypes":true,"includeDescriptions":true}'Envie uma requisição POST com suas entradas em JSON. Parâmetros do tipo arquivo exigem upload prévio.
POST https://api.elysiatools.com/pt/api/tools/openapi-to-typescript-generator| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| specInput | textarea | Sim | — |
| sourceFormat | select | Não | — |
| outputFormat | select | Não | — |
| namingStyle | select | Não | — |
| declarationStyle | select | Não | — |
| namespaceName | text | Não | — |
| includeOperationTypes | checkbox | Não | — |
| includeDescriptions | checkbox | Não | — |
Resultado de texto
{
"result": "Processed text content",
"error": "Error message (optional)",
"message": "Notification message (optional)",
"metadata": {
"key": "value"
}
}Adicione esta ferramenta ao seu servidor Model Context Protocol para que agentes de IA possam listá-la e chamá-la.
Adicione este bloco à configuração do seu cliente MCP:
{
"mcpServers": {
"elysiatools-openapi-to-typescript-generator": {
"name": "openapi-to-typescript-generator",
"description": "Converte especificacoes OpenAPI ou Swagger em JSON/YAML em tipos TypeScript, parametros de requisicao e modelos de resposta com formato de saida e estilo de nomes configuraveis",
"baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=openapi-to-typescript-generator",
"command": "",
"args": [],
"env": {},
"isActive": true,
"type": "sse"
}
}
}Após conectar ao endpoint SSE, liste as ferramentas expostas:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}Invoque a ferramenta pelo seu id; os argumentos são construídos a partir de seus parâmetros:
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "openapi-to-typescript-generator",
"arguments": {
"specInput": "openapi: 3.0.0\ninfo:\n title: User API\n version: 1.0.0\npaths:\n /users/{id}:\n get:\n operationId: getUser\n parameters:\n - in: path\n name: id\n required: true\n schema:\n type: string\n responses:\n \"200\":\n description: ok\n content:\n application/json:\n schema:\n $ref: \"#/components/schemas/User\"\ncomponents:\n schemas:\n User:\n type: object\n required: [id, name]\n properties:\n id:\n type: string\n name:\n type: string",
"sourceFormat": "yaml",
"outputFormat": "flat",
"namingStyle": "pascal",
"declarationStyle": "interface",
"namespaceName": "Api",
"includeOperationTypes": true,
"includeDescriptions": true
}
}
}Dúvidas ou problemas? Contate [email protected]