GraphQL Schema MCP Server

Co dělá “GraphQL Schema” MCP Server?

Model Context Protocol (MCP) Server pro GraphQL Schema je specializovaný nástroj, který umožňuje AI asistentům (například Claude) pracovat s GraphQL schématy a porozumět jim. Díky zpřístupnění detailů schématu pomocí sady specializovaných nástrojů umožňuje velkým jazykovým modelům prozkoumávat dotazovací, mutační a subscription pole, vyhledávat definice typů a provádět hledání podle vzorů napříč schématem. To zefektivňuje vývojové workflow tím, že LLM mohou odpovídat na detailní dotazy ohledně API, pomáhat s integrací API a automatizovat úkoly dokumentace či generování kódu týkající se systémů založených na GraphQL. Server lze spustit s libovolným souborem GraphQL schématu, což poskytuje flexibilní základ pro analýzu schémat, prozkoumávání kódu a podporu vývojářů.

Seznam promptů

V repozitářové dokumentaci ani v kódu nejsou uvedeny žádné konkrétní šablony promptů.

Seznam zdrojů

V dokumentaci ani v kódu nejsou uvedeny žádné explicitní zdroje dle MCP standardu.

Seznam nástrojů

• list-query-fields: Vypíše všechna dostupná kořenová pole pro GraphQL dotazy (queries).
• get-query-field: Získá detailní definici konkrétního dotazovacího pole ve formátu SDL (Schema Definition Language).
• list-mutation-fields: Vypíše všechna dostupná kořenová pole pro GraphQL mutace.
• get-mutation-field: Získá detailní definici konkrétního mutačního pole ve formátu SDL.
• list-subscription-fields: Vypíše všechna dostupná kořenová pole pro GraphQL subscriptions (pokud jsou ve schématu přítomna).
• get-subscription-field: Získá detailní definici konkrétního subscription pole (pokud je ve schématu přítomné).
• list-types: Vypíše všechny typy definované v GraphQL schématu (kromě interních typů).
• get-type: Získá detailní definici konkrétního GraphQL typu ve formátu SDL.
• get-type-fields: Získá zjednodušený seznam polí včetně jejich typů pro konkrétní GraphQL objektový typ.
• search-schema: Vyhledá typy nebo pole ve schématu podle vzoru názvu (case-insensitive regex).

Příklady využití tohoto MCP serveru

• Prozkoumávání GraphQL API: Umožňuje vývojářům i LLM rychle objevit dostupné dotazy, mutace a subscriptions v GraphQL API, což urychluje onboardování i tvorbu dokumentace.
• Asistence s dokumentací schématu: Automatizuje extrakci definic typů a detailů polí, což podporuje generování či aktualizaci dokumentace API.
• Integrace do kódu: Umožňuje LLM odpovídat na dotazy k datovým modelům a dostupným operacím, což podporuje generování kódu, testování nebo refaktoring v souvislosti s GraphQL API.
• Plánování integrace API: Usnadňuje inteligentní návrhy, jak s API pracovat, díky programovému zpřístupnění typů polí, argumentů a dostupných operací.
• Vyhledávání a analýza schématu: Umožňuje nalézt typy a pole odpovídající konkrétním vzorům, což pomáhá při auditu, migracích nebo pochopení složitých API.

Jak to nastavit

Windsurf

V repozitáři nejsou uvedeny žádné konkrétní pokyny k nastavení Windsurf.

Claude

1. Předpoklady: Ujistěte se, že máte nainstalovaný Node.js a npx.
2. Najděte konfigurační soubor: Najděte claude_desktop_config.json:
   • macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: $env:AppData\Claude\claude_desktop_config.json
3. Upravte konfiguraci: Přidejte GraphQL Schema MCP server do objektu mcpServers.
4. Přidejte server: Příklad JSON konfigurace:

   {
     "mcpServers": {
       "GraphQL Schema": {
         "command": "npx",
         "args": ["-y", "mcp-graphql-schema", "/ABSOLUTE/PATH/TO/schema.graphqls"]
       }
     }
   }
   

5. Uložte a restartujte: Uložte soubor a restartujte Claude Desktop.
6. Ověřte nastavení: Zkontrolujte, že server běží a je v Claude dostupný.

Cursor

V repozitáři nejsou uvedeny žádné konkrétní pokyny k nastavení Cursor.

Cline

V repozitáři nejsou uvedeny žádné konkrétní pokyny k nastavení Cline.

Zabezpečení API klíčů

V repozitáři nejsou uvedeny žádné informace o zabezpečení API klíčů nebo konfiguraci proměnných prostředí.

Jak používat tento MCP ve flow

Použití MCP ve FlowHunt

Pro integraci MCP serverů do vašeho workflow ve FlowHunt začněte přidáním MCP komponenty do svého flow a propojte ji s AI agentem:

Klikněte na MCP komponentu pro otevření konfiguračního panelu. V sekci systémové konfigurace MCP vložte údaje o svém MCP serveru v tomto formátu JSON:

{
  "MCP-name": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Po konfiguraci může AI agent tento MCP využívat jako nástroj se všemi jeho funkcemi a možnostmi. Nezapomeňte změnit “MCP-name” na skutečný název vašeho MCP serveru (např. “github-mcp”, “weather-api” atd.) a URL nahraďte adresou vašeho MCP serveru.

Přehled

Na základě výše uvedených údajů je tento MCP server solidní pro prozkoumávání a práci se schématy GraphQL, ale postrádá explicitní prompty, zdroje a dokumentaci k bezpečnosti klíčů. Je velmi zaměřený na svůj obor a dobře zdokumentován pro použití s Claude.

Náš názor

Tento MCP server je vysoce specializovaný a efektivní pro analýzu GraphQL schémat, s robustní podporou nástrojů a jasnou dokumentací pro integraci s Claude. Absence šablon promptů, explicitních definic zdrojů a správy prostředí/klíčů však omezuje jeho obecnější použitelnost a snadné bezpečné nasazení. O podpoře rootů a vzorkování není zmínka, což může ovlivnit pokročilejší integrace. Celkově jde o silný a spolehlivý MCP pro cílené využití, ale pro širší použití a bezpečnost by mohl být dále rozšířen.

MCP skóre