Siirry pääsisältöön

MCP Server

Avaa ChatGPT:ssä

webforJ Model Context Protocol (MCP) -palvelin tarjoaa AI-avustajille suoran pääsyn virallisiin webforJ-dokumentaatioihin, vahvistettuihin koodiesimerkkeihin ja kehykselle spesifisiin kaavoihin, mikä mahdollistaa tarkempien vastausten ja automaattisen projektin luomisen erityisesti webforJ-kehitykselle.

Mikä on MCP?​

Model Context Protocol on avointa standardia, joka mahdollistaa AI-avustajien yhdistämisen ulkoisiin työkaluihin ja dokumentaatioon. webforJ MCP -palvelin toteuttaa tätä protokollaa tarjoten:

  • Tietohaun - Luonnollisen kielen haku webforJ-dokumentaatiossa, koodiesimerkeissä ja kaavoissa
  • Projektin luomisen - Luo webforJ-sovelluksia virallisten mallien avulla oikealla rakenteella
  • Teemojen luomisen - Luo saavutettavia CSS-teemoja webforJ:n suunnittelukaavojen mukaisesti

Miksi käyttää MCP:tä?​

Vaikka AI-koodaavustajat ovat hyviä vastaamaan peruskysymyksiin, ne kamppailevat monimutkaisten webforJ-spesifisten kysymysten kanssa, jotka ulottuvat useisiin dokumentaatiosiltoihin. Ilman suoraa pääsyä virallisiin lähteisiin ne voivat:

  • Luoda metodeja, joita ei ole webforJ:ssä
  • Viitata vanhentuneisiin tai virheellisiin API-kaavoihin
  • Tarjota koodia, joka ei käänny
  • Sekoitella webforJ-syntaksia muiden Java-kehysten kanssa
  • Väärinymmärtää webforJ-spesifisiä kaavoja

MCP-integraation avulla AI-vastaukset ovat sidottuja todelliseen webforJ-dokumentaatioon, koodiesimerkkeihin ja kehyskaavoihin, tarjoten varmennettavia vastauksia ja suoria linkkejä virallisiin lähteisiin syvempää tutkimusta varten.

AI voi silti tehdä virheitä

Vaikka MCP parantaa tarkkuutta merkittävästi tarjoamalla pääsyn virallisiin webforJ-resursseihin, se ei takaa täydellistä koodin luomista. AI-avustajat voivat silti tehdä virheitä monimutkaisissa tilanteissa. Tarkista aina luotu koodi ja testaa kattavasti ennen käyttöä tuotannossa.

Asennus​

webforJ MCP -palvelin isännöi osoitteessa https://mcp.webforj.com ja siinä on kaksi päätepistettä:

  • MCP-päätepiste (/mcp) - Claude, VS Code, Cursor
  • SSE-päätepiste (/sse) - Vanhoille asiakkaille

Käytä Claude CLI -komentoa rekisteröidäksesi palvelimen:

claude mcp add webforj-mcp https://mcp.webforj.com/mcp -t http -s user

Tämä konfiguroi MCP-palvelimen automaattisesti Claude Code -ympäristössäsi.

Saatavilla olevat työkalut​

Työkalut ovat erikoistuneita toimintoja, joita MCP-palvelin tarjoaa AI-avustajille. Kun esität kysymyksen tai teet pyynnön, AI voi kutsua näitä työkaluja hakemaan dokumentaatiota, luomaan projekteja tai luomaan teemoja. Jokainen työkalu hyväksyy tiettyjä parametreja ja palauttaa jäsenneltyä dataa, joka auttaa AI:ta tarjoamaan tarkkaa ja kontekstuaalista apua.

Tämä työkalu tarjoaa semanttisen hakutoiminnallisuuden koko webforJ-dokumentaatioekosysteemissä. Se ymmärtää kontekstin ja suhteen eri kehyskonseptien välillä, palauttaen olennaisia dokumentaatiosektioita, API-viittauksia ja toimivia koodiesimerkkejä.

Esimerkkikyselyt:

"Hae webforJ-dokumentaatiosta Button-komponenttia ikoniesimerkeillä"

"Etsi webforJ-lomakevalidointikaavoja uusimmasta dokumentaatiosta"

"Näytä nykyinen webforJ-reititysasetukset @Route-annotaatiolla"

"Hae webforJ-dokumenteista FlexLayout-vastauksellisia suunnittelukaavoja"

"Etsi webforJ-verkkokomponentti-integraatio virallisesta dokumentaatiosta"

Rakentaa täydellisiä webforJ-sovelluksia virallisten Maven-archetypejen avulla. Työkalu luo standardoidun projektikansiorakenteen ja sisältää aloituskoodin valitun mallin perusteella. Luodut projektit sisältävät valmiin rakennusjärjestelmän, resurssikansiot ja konfiguraatiotiedostot välitöntä kehittämistä ja käyttöönottoa varten.

Esimerkkikehotteet:

"Luo webforJ-projekti nimeltä CustomerPortal hello-world-archetypen avulla"

"Generoi webforJ Spring Boot -projekti, jossa on välilehtirakenne nimeltä Dashboard"

"Luo uusi webforJ-sovellus sidemenu-archetypelle AdminPanel-projektille"

"Generoi tyhjää webforJ-projektia nimeltä TestApp, jossa on com.example groupId"

"Luo webforJ-projekti InventorySystem käyttäen sidemenu-archetypea Spring Bootin kanssa"

Kun käytät tätä työkalua, voit valita useista projektimalleista:

Archetypen (projektimallit):

  • hello-world - Perussovellus, jossa on esimerkkikomponentteja webforJ-ominaisuuksien esittelemiseksi
  • blank - Minimimallin rakenne aloittamista varten tyhjältä
  • tabs - Esirakennettu välilehtikäyttöliittymän asettelu moninäkymäsovelluksille
  • sidemenu - Sivunavigaatiovalikko asettelulle hallintapaneeleille tai koontinäytöille

Muut (kehysintegraatio):

  • webforj - Standardi webforJ-sovellus
  • webforj-spring - webforJ integroitu Spring Bootin kanssa riippuvuusten injektoimiseksi ja yritysominaisuuksien tarjoamiseksi
Saatavilla olevat archetypet

webforJ:ssä on useita ennalta määrättyjä archetypeja, jotka auttavat sinua pääsemään nopeasti alkuun. Täydellisen luettelon saatavilla olevista archetypeista katso archetype-katalogista.

Generoi webforJ-teemakonfiguraatioita käyttämällä DWC HueCraft. Työkalu luo täydelliset CSS-muuttujakokoelmat ensisijaisille, toissijaisille, menestysohjeille, varoituksille, vaarallisille ja neutraaleille värivariantteille.

Esimerkkipyynnöt:

"Generoi webforJ-teema, jossa on HSL 220, 70, 50 ensisijaisena värinä meille yritysbrändissä"

"Luo webforJ-saavutettava teema nimeltä 'ocean' pääväri #0066CC"

"Generoi webforJ-teema käyttäen brändiväriämme #FF5733"

"Luo webforJ-teema, jossa on HSL 30, 100, 50 nimeltä 'sunset' sovelluksemme varten"

"Generoi saavutettava webforJ-teema, jossa on ensisijainen RGB 44, 123, 229"

Saatavilla olevat kehotteet​

Kehoteet ovat esikonfiguroituja AI-ohjeita, jotka yhdistävät useita työkaluja ja työprosesseja yleisiin tehtäviin. Ne ohjaavat AI:ta tiettyjen vaiheiden ja parametrien kautta luodakseen luotettavia ja toistettavia tuloksia jokaiselle tuetulle työprosessille.

Argumentit:

  • appName (pakollinen) - Sovelluksen nimi (esim. MyApp, TodoList, Dashboard)
  • archetype (pakollinen) - Valitse: blank, hello-world, tabs, sidemenu
  • runServer (valinnainen) - Aja kehityspalvelin automaattisesti (kyllä/ei)

Argumentit:

  • primaryColor (pakollinen) - Väri heksadesimaalimuodossa (#FF5733), rgb (255,87,51) tai hsl (9,100,60) muodossa

Kehote konfiguroi AI:n:

  1. Etsi tietopohjaa laajasti
  2. Kirjoita täydellistä tuotantovalmiina koodia
  3. Käännä projekti käyttäen mvn compile varmistaaksesi, että rakennusvirheitä ei ole
  4. Korjaa virheitä iteroivasti, kunnes kaikki toimii

Kuinka käyttää kehotteita​

  1. Kirjoita / keskusteluun nähdäksesi saatavilla olevat kehotteet
  2. Valitse kehotte tutustumisvalikosta
  3. Täytä tarvittavat parametrit, kun sinua pyydetään

Parhaat käytännöt​

Saadaksesi tarkimman ja ajantasaisimman webforJ-avustuksen, seuraa näitä ohjeita, jotta voit hyödyntää MCP-palvelimen ominaisuuksia täydellisesti.

MCC-palvelimen käytön varmistaminen​

AI-mallit saattavat ohittaa MCP-palvelimen, jos ne uskovat tietävänsä vastauksen jo. Varmistaaksesi, että MCP-palvelinta todella käytetään:

  • Ole eksplisiittinen webforJ:stä: Mainitse aina "webforJ" kysymyksesi yhteydessä laukaistaksesi kehyskohtaisia hakuja
  • Pyydä ajankohtaista tietoa: Sisällytä lauseita kuten "uusin webforJ-dokumentaatio" tai "nykyiset webforJ-kaavat"
  • Pyydä varmennettuja esimerkkejä: Pyydä "toimivia webforJ-koodiesimerkkejä" pakottaaksesi dokumentoinnin haun
  • Viittaa erityisiin versioihin: Mainitse webforJ-versionisi (esim. "webforJ 25.02") saadaksesi tarkkoja tuloksia

Kirjoita tarkkoja kehotteita​

Hyviä esimerkkejä:

"Hae webforJ-dokumentaatiosta Button-komponentin tapahtumakäsittely esimerkkien kanssa"

"Luo webforJ-projekti nimeltä InventorySystem käyttäen sidemenu-archeptypea Spring Bootin kanssa"

"Generoi webforJ-teema, jossa HSL 220, 70, 50 on ensisijainen väri yritysbrändille"

Huonoja esimerkkejä:

"Kuinka napit toimivat"

"Tehdään sovellus"

"Tehdään se siniseksi"

Pakota MCP-työkalun käyttö​

Jos AI antaa yleisiä vastauksia ilman MCP-palvelimen käyttöä:

  1. Pyydä eksplisiittisesti: "Käytä webforJ MCP -palvelinta etsimään [kysymys]"
  2. Kysy dokumentaatioviittauksia: "Etsi webforJ-dokumenteista kuinka [kysymys]"
  3. Pyydä varmennusta: "Vahvista tämä ratkaisu webforJ-dokumentaation mukaan"
  4. Ole kehyskohtainen: Mainitse aina "webforJ" kysymyksissäsi

AI-kustomointi​

Määritä AI-avustajasi käyttämään automaattisesti MCP-palvelinta ja noudattamaan webforJ:n parhaita käytäntöjä. Lisää projektikohtaisia ohjeita, jotta AI-avustajasi käyttävät aina MCP-palvelinta, noudattavat webforJ:n dokumentaatiostandardeja ja tarjoavat tarkkoja, ajantasaisia vastauksia, jotka vastaavat tiimisi vaatimuksia.

Projektin konfiguraatiotiedostot​

  • VS Code ja Copilot -luo .github/copilot-instructions.md
  • Claude Code -luo CLAUDE.md projektin juureen

Lisää seuraava luomasi markdown-tiedosto:

## Käytä webforJ MCP -palvelinta vastataksesi kaikkiin webforJ-kysymyksiin

- Kutsu aina "webforj-knowledge-base" työkalua hakemaan kysymykseen liittyvää dokumentaatiota
- Vahvista kaikki API-allekirjoitukset virallisen dokumentaation mukaisesti
- Älä koskaan oleta, että metodien nimiä tai parametreja on olemassa ilman tarkistamista

Varmista aina, että koodi kääntyy komennolla `mvn compile` ennen ehdotusta.

UKK​

Useimmat AI-avustajat tarvitsevat eksplisiittisiä ohjeita käyttääkseen MCP-palvelimia. Määritä AI-asiakasi ohjeiden avulla AI-kustomoinnissa. Ilman näitä ohjeita AI-avustajat saattavat palata koulutustietoihinsa sen sijaan, että kysyisivät MCP-palvelimelta.

Nopea ratkaisu: Sisällytä "käytä webforJ MCP" kehotteeseesi tai luo tarvittava konfiguraatiotiedosto (.github/copilot-instructions.md tai CLAUDE.md).

Käytä MCP-inspectoria debugataksesi yhteyksiä:

npx @modelcontextprotocol/inspector

Odota viestiä: 🔍 MCP Inspector on käynnissä osoitteessa http://127.0.0.1:6274 (portti saattaa vaihdella)

Sitten inspektorissa:

  1. Syötä MCP-palvelimen URL-osoite: https://mcp.webforj.com/mcp
  2. Napsauta "Yhdistä" muodostaaksesi yhteyden
  3. Näe saatavilla olevat työkalut ja testauskyselyt
  4. Seuraa pyyntö-/vastauslokit debugataksesi

webforJ MCP -palvelin tarjoaa kaksi päätepistettä:

  • MCP-päätepiste (/mcp) - Moderni protokolla Claudea, VS Codea, Cursoria varten
  • SSE-päätepiste (/sse) - Server-Sent Events vanhoille asiakkaille, kuten Windsurf

Useimpien käyttäjien tulisi käyttää MCP-päätepistettä. Käytä vain SSE:ta, jos asiakas ei tue standardia MCP-protokollaa.

Kyllä, mutta se ei ole suositeltavaa. Ilman konfiguraatiotiedostoja sinun on manuaalisesti kehotettava AI:tä käyttämään MCP-palvelinta jokaisessa keskustelussa. Konfiguraatiotiedostot ohjeistavat automaattisesti AI:ta käyttämään MCP-palvelinta jokaisessa vuorovaikutuksessa, joten sinun ei tarvitse toistaa ohjeita joka kerta.

Manuaalinen lähestymistapa: Aloita kehotteet sanoin: "Käytä webforJ MCP -palvelinta..."

Vaihtoehtoisesti: Käytä esikonfiguroituja kehotteita MCP-palvelin tarjoaa kehotteita, jotka toimivat ilman konfiguraatiotiedostoja:

  • /create-app - Generoi uusia webforJ-sovelluksia
  • /create-theme - Luo saavutettavia CSS-teemoja
  • /search-webforj - Edistynyt dokumentaation haku

Katso Saatavilla olevat kehotteet lisätietoja varten.

Raportoi ongelmat: webforJ MCP Ongelmatunnusmalli

Yleiset ongelmat, joita raportoida:

  • Vanha dokumentaatio hakutuloksissa
  • Puuttuvat API-metodit tai komponentit
  • Virheelliset koodiesimerkit
  • Työkalun suoritusvirheet

Sisällytä kysymyksesi, odotettu tulos ja todellinen tulos, kun raportoit ongelmia.