Skip to content

Commit f270dc0

Browse files
LasimLasim
committed
feat(backend): add endpoints for retrieving unique languages and runtimes
1 parent 13da4a1 commit f270dc0

File tree

6 files changed

+645
-0
lines changed

6 files changed

+645
-0
lines changed

‎services/backend/api-spec.json‎

Lines changed: 234 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15168,6 +15168,240 @@
1516815168
}
1516915169
}
1517015170
},
15171+
"/api/mcp/servers/languages": {
15172+
"get": {
15173+
"summary": "Get all unique programming languages",
15174+
"tags": [
15175+
"MCP Servers"
15176+
],
15177+
"description": "Retrieve all unique programming languages from MCP servers using DISTINCT query for optimal performance. Results are sorted alphabetically.",
15178+
"security": [
15179+
{
15180+
"cookieAuth": []
15181+
}
15182+
],
15183+
"responses": {
15184+
"200": {
15185+
"description": "Languages retrieved successfully",
15186+
"content": {
15187+
"application/json": {
15188+
"schema": {
15189+
"type": "object",
15190+
"properties": {
15191+
"success": {
15192+
"type": "boolean",
15193+
"description": "Indicates successful languages retrieval"
15194+
},
15195+
"data": {
15196+
"type": "object",
15197+
"properties": {
15198+
"languages": {
15199+
"type": "array",
15200+
"items": {
15201+
"type": "string"
15202+
},
15203+
"description": "Array of unique programming languages sorted alphabetically"
15204+
},
15205+
"total": {
15206+
"type": "number",
15207+
"description": "Total number of unique languages"
15208+
}
15209+
},
15210+
"required": [
15211+
"languages",
15212+
"total"
15213+
],
15214+
"additionalProperties": false
15215+
}
15216+
},
15217+
"required": [
15218+
"success",
15219+
"data"
15220+
],
15221+
"additionalProperties": false,
15222+
"description": "Languages retrieved successfully"
15223+
}
15224+
}
15225+
}
15226+
},
15227+
"401": {
15228+
"description": "Unauthorized - Authentication required",
15229+
"content": {
15230+
"application/json": {
15231+
"schema": {
15232+
"type": "object",
15233+
"properties": {
15234+
"success": {
15235+
"type": "boolean",
15236+
"default": false,
15237+
"description": "Indicates the operation failed"
15238+
},
15239+
"error": {
15240+
"type": "string",
15241+
"description": "Error message describing what went wrong"
15242+
},
15243+
"details": {
15244+
"description": "Additional error details"
15245+
}
15246+
},
15247+
"required": [
15248+
"success",
15249+
"error"
15250+
],
15251+
"description": "Unauthorized - Authentication required"
15252+
}
15253+
}
15254+
}
15255+
},
15256+
"500": {
15257+
"description": "Internal Server Error",
15258+
"content": {
15259+
"application/json": {
15260+
"schema": {
15261+
"type": "object",
15262+
"properties": {
15263+
"success": {
15264+
"type": "boolean",
15265+
"default": false,
15266+
"description": "Indicates the operation failed"
15267+
},
15268+
"error": {
15269+
"type": "string",
15270+
"description": "Error message describing what went wrong"
15271+
},
15272+
"details": {
15273+
"description": "Additional error details"
15274+
}
15275+
},
15276+
"required": [
15277+
"success",
15278+
"error"
15279+
],
15280+
"description": "Internal Server Error"
15281+
}
15282+
}
15283+
}
15284+
}
15285+
}
15286+
}
15287+
},
15288+
"/api/mcp/servers/runtimes": {
15289+
"get": {
15290+
"summary": "Get all unique runtime environments",
15291+
"tags": [
15292+
"MCP Servers"
15293+
],
15294+
"description": "Retrieve all unique runtime environments from MCP servers using DISTINCT query for optimal performance. Results are sorted alphabetically.",
15295+
"security": [
15296+
{
15297+
"cookieAuth": []
15298+
}
15299+
],
15300+
"responses": {
15301+
"200": {
15302+
"description": "Runtimes retrieved successfully",
15303+
"content": {
15304+
"application/json": {
15305+
"schema": {
15306+
"type": "object",
15307+
"properties": {
15308+
"success": {
15309+
"type": "boolean",
15310+
"description": "Indicates successful runtimes retrieval"
15311+
},
15312+
"data": {
15313+
"type": "object",
15314+
"properties": {
15315+
"runtimes": {
15316+
"type": "array",
15317+
"items": {
15318+
"type": "string"
15319+
},
15320+
"description": "Array of unique runtime environments sorted alphabetically"
15321+
},
15322+
"total": {
15323+
"type": "number",
15324+
"description": "Total number of unique runtimes"
15325+
}
15326+
},
15327+
"required": [
15328+
"runtimes",
15329+
"total"
15330+
],
15331+
"additionalProperties": false
15332+
}
15333+
},
15334+
"required": [
15335+
"success",
15336+
"data"
15337+
],
15338+
"additionalProperties": false,
15339+
"description": "Runtimes retrieved successfully"
15340+
}
15341+
}
15342+
}
15343+
},
15344+
"401": {
15345+
"description": "Unauthorized - Authentication required",
15346+
"content": {
15347+
"application/json": {
15348+
"schema": {
15349+
"type": "object",
15350+
"properties": {
15351+
"success": {
15352+
"type": "boolean",
15353+
"default": false,
15354+
"description": "Indicates the operation failed"
15355+
},
15356+
"error": {
15357+
"type": "string",
15358+
"description": "Error message describing what went wrong"
15359+
},
15360+
"details": {
15361+
"description": "Additional error details"
15362+
}
15363+
},
15364+
"required": [
15365+
"success",
15366+
"error"
15367+
],
15368+
"description": "Unauthorized - Authentication required"
15369+
}
15370+
}
15371+
}
15372+
},
15373+
"500": {
15374+
"description": "Internal Server Error",
15375+
"content": {
15376+
"application/json": {
15377+
"schema": {
15378+
"type": "object",
15379+
"properties": {
15380+
"success": {
15381+
"type": "boolean",
15382+
"default": false,
15383+
"description": "Indicates the operation failed"
15384+
},
15385+
"error": {
15386+
"type": "string",
15387+
"description": "Error message describing what went wrong"
15388+
},
15389+
"details": {
15390+
"description": "Additional error details"
15391+
}
15392+
},
15393+
"required": [
15394+
"success",
15395+
"error"
15396+
],
15397+
"description": "Internal Server Error"
15398+
}
15399+
}
15400+
}
15401+
}
15402+
}
15403+
}
15404+
},
1517115405
"/api/mcp/servers/global": {
1517215406
"post": {
1517315407
"summary": "Create global MCP server (Global Admin only)",

0 commit comments

Comments
 (0)