Lista servrar
GET /servers
Sök och bläddra bland publika MCP-servrar i registret. Stödjer fulltext- och
semantisk sökning via q-parametern, och filtrering på deploymentstatus,
verifiering, ägare med mera.
Autentisering
Se Autentisering (API-nyckel).
Parametrar
Sökning
| Parameter | Typ | Beskrivning |
|---|
q | string | Sökfråga för fulltext- och semantisk sökning bland servernamn och beskrivningar |
topK | integer | Max antal kandidater från sökindex innan paginering (10-500). Använd seed för stabil djup paginering |
Paginering
| Parameter | Typ | Beskrivning |
|---|
page | integer | Sidnummer, 1-indexerat |
pageSize | integer | Antal resultat per sida (standard 10, max 100) |
seed | integer | Random seed för determinisk paginering. Ger deterministisk sortering mellan sidor |
Filtrering
| Parameter | Typ | Beskrivning |
|---|
ids | string[] | Filtrera på specifika server-UUID:n |
namespace | string | Filtrera på namespace |
ownerId | string | Filtrera på ägarens användar-ID |
remote | "0" \| "1" \| "true" \| "false" | Filtrera på fjärransluten (true) eller lokal stdio (false) |
isDeployed | "0" \| "1" \| "true" \| "false" | Filtrera på deploymentstatus |
verified | "0" \| "1" \| "true" \| "false" | Filtrera på verifierade servrar |
silaiManaged | "0" \| "1" \| "true" \| "false" | Filtrera på servrar vars namespace ägs av Silai |
qualifiedName | string | Exakt matchning på serverns kvalificerade namn, t.ex. "namespace/server" |
repoOwner | string | Filtrera på GitHub-repoägare |
repoName | string | Filtrera på GitHub-reponamn |
Övriga
| Parameter | Typ | Beskrivning |
|---|
fields | string | Kommaseparerad lista med fält att inkludera i svaret |
Svar
200 Servrar hittade
| Fält | Typ | Beskrivning |
|---|
servers | ServerSummary[] | Lista med servrar (se ServerSummary) |
pagination | object | Pagineringsinfo (se Pagination) |
400 Ogiltig begäran
| Fält | Typ | Beskrivning |
|---|
error | string | Felmeddelande |
401 Ej autentiserad
| Fält | Typ | Beskrivning |
|---|
error | string | Felmeddelande |
422 Obearbetbar entitet
| Fält | Typ | Beskrivning |
|---|
error | string | Felmeddelande |
Kodexempel
const params = new URLSearchParams({
q: 'weather',
pageSize: '20',
verified: 'true'
});
const res = await fetch(
`https://api.silai.se/servers?${params}`,
{
headers: { Authorization: 'Bearer YOUR_API_KEY' }
}
);
const data = await res.json();
console.log(data.pagination.totalCount);
for (const server of data.servers) {
console.log(server.qualifiedName, server.useCount);
}
Scheman
ServerSummary
| Fält | Typ | Beskrivning |
|---|
id | string | Internt ID |
qualifiedName | string | Unikt namn i formatet namespace/slug |
namespace | string \| null | Namespace servern tillhör |
slug | string \| null | URL-vänligt kortnamn inom namespacet |
displayName | string | Visningsnamn |
description | string | Beskrivning |
iconUrl | string \| null | URL till ikon |
verified | boolean | Om servern är verifierad |
useCount | number | Antal anslutningar totalt |
remote | boolean \| null | true för fjärransluten, false för lokal stdio |
isDeployed | boolean | Om servern hostas på plattformen |
createdAt | string | ISO 8601-tidsstämpel för registrering |
homepage | string | Ägarens hemsida eller serverns plattformssida |
bySilai | boolean | Om servern underhålls av plattformen |
owner | string \| null | Ägarens användar-ID |
score | number \| null | Relevanspoäng från sökning (null vid bläddring) |
| Fält | Typ | Beskrivning |
|---|
currentPage | integer | Aktuellt sidnummer (1-indexerat) |
pageSize | integer | Antal resultat per sida |
totalPages | integer | Totalt antal sidor |
totalCount | integer | Totalt antal matchande servrar |