MCP-palvelin

Altista valitun sovelluksen ominaisuudet paikallisille MCP-asiakkaille

MCP-palvelin-sivu käynnistää ja pysäyttää sovelluksen paikallisen Mallikontekstiprotokollan palvelimen. MCP mahdollistaa yhteensopivan asiakkaan, kuten AI-avustajan tai automaatiotyökalun, löytää sovelluksen tarjoamat työkalut ja pyytää näitä työkaluja paikallisen HTTP-päätteen kautta.

Palvelin on rakennettu käynnissä olevaan sovellukseen. Se ei ole erillinen komentorivipalvelu, eikä se ole julkinen internet-palvelu. Käynnistä se vain, kun haluat MCP-asiakkaan yhdistyvän.

Mitä MCP voi hallita

MCP altistaa sovelluksen nimenomaisesti julkaistut alueen ominaisuudet. Se ei ole yleinen etäohjauspinta sovelluksen ikkunalle.

Jotkut sovellukset saattavat alkaa vain yleisellä MCP-isäntäpinnalla. Sovelluskohtaisia MCP-moduuleja voidaan lisätä, kun alueen ominaisuudet ovat saatavilla.

Sivun ohjaimet

  • Aloita isännöinti MCP-päätettä.
  • Pysäytä lopettaa MCP-päätteen ja vapauttaa portti.
  • Osoite asettaa paikallisen osoitteen, johon kuunnellaan.
  • Portti asettaa TCP-portin.
  • Konfiguroitu pääte näyttää URL-osoitteen, joka annetaan MCP-asiakkaalle.
  • Kopioi URL kopioi konfiguroidun päätepisteen.
  • Bearer-token on token, jonka asiakkaat on lähetettävä pyyntöjen mukana.
  • Kopioi token kopioi tokenin.
  • Uudelleenluo token luo uuden tokenin ja mitätöi vanhan sen jälkeen, kun palvelin on käynnistetty uudelleen.
  • Moduulit luettelee sovelluksen ilmoittamat MCP-moduulit.
  • Ota käyttöön tai poista käytöstä ohjaa, vaikuttaako moduuli työkalujen tarjoamiseen palvelimelle.
  • Lokit näyttävät palvelimen käynnistys-, pysäytys-, pyyntö-, hylkäys- ja työkalukutsuviestit.
  • Tyhjennä Lokissa oikealla hiiren painikkeella avattavasta valikosta tyhjentää näkyvän sivulokin.

Oletuspääte on:

http://127.0.0.1:50507/mcp

Palvelin käynnistyy vain, kun vähintään yksi moduuli on käytössä ja bearer-token ei ole tyhjää. Osoite, Portti, Bearer-token ja moduuliasetukset ovat profiilivarmistettuja. Jos MCP-palvelin on käynnissä, kun profiili tallennetaan tai sovellus suljetaan, tämä profiili voi käynnistää sen uudelleen seuraavalla kerralla.

Osoite ja portti

Käytä 127.0.0.1 kun MCP-asiakas toimii samalla tietokoneella. Tämä on turvallisin ja yleisin asetus.

Käytä LAN IPv4 -osoitetta, joka on määritetty tälle tietokoneelle vain, kun luotettu asiakas samalla yksityisverkolla on pakko yhdistää. Villikortti-, lähetys-, ei-lokaliset ja ei-IPv4-sidokset hylätään.

Älä altista MCP-päätettä reitittimen porttiohjauksen, julkisen Wi-Fi:n, luottamattomien VPN:ien tai internetiin suuntautuvien palomuurisääntöjen kautta. MCP-työkalut voivat pyytää todellisia sovellustoimintoja, joten käsittele päätettä ja tokenia kuin paikallista ohjausavainta.

Yhdistä asiakas

Käytä Streamable HTTP MCP -asiakasta. Määritä asiakas seuraavasti:

  1. Päätteen URL: konfiguroitu pääte, joka näkyy sivulla.
  2. Valtuutusotsikko: Authorization: Bearer your-token.

Useimmat asiakkaat kysyvät URL-osoitetta ja bearer-tokenia tai mukautettua otsikkoa. Jos asiakkaasi tallentaa otsikot erikseen, käytä:

Header name: Authorization
Header value: Bearer your-token

Korvaa your-token tokenilla, joka näkyy MCP-palvelin-sivulla. Älä sisällytä lainausmerkkejä tokenin ympärille.

Tekninen pyyntömuoto

MCP-asiakkaat lähettävät normaalisti nämä pyynnöt puolestasi. Alla olevat tiedot ovat hyödyllisiä asiakasta määritettäessä tai vianetsittäessä.

Pääte hyväksyy HTTP POST -pyynnöt /mcp. Pyyntöruumiin on oltava JSON-RPC. Asiakkaan on sisällytettävä bearer-token, kun token on määritetty.

Alustava pyyntö:

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"local-client","version":"1.0"}}}

Alustettu ilmoitus:

{"jsonrpc":"2.0","method":"notifications/initialized","params":{}}

Työkalujen lista:

{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}

Kutsu työkalua:

{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"module_tool_name","arguments":{}}}

Palvelin palauttaa jäsennellyt työkalutulokset. Odotetut sovelluksen hylkäykset, kuten pyydetyn toiminnon olevan saatavilla, palautetaan normaalina työkalutuloksena, jossa ok on asetettu false:ksi.

Palvelimen tilat

  • Pysäytetty tarkoittaa, että pääte ei kuuntele.
  • Käynnistetty tarkoittaa, että pääte kuuntelee määritetyssä osoitteessa ja portissa.
  • Valmis käynnistämään MCP-palvelin tarkoittaa, että sivu on ladattu ja asetukset ovat käytettävissä.
  • MCP-isäntä käynnistetty tarkoittaa, että palvelin käynnistyi onnistuneesti.
  • MCP-isäntä pysäytetty tarkoittaa, että palvelin pysähtyi normaalisti.
  • Ei MCP-aikaisemaa rekisteröity tarkoittaa, että sovellus ei ilmoittanut MCP-aikaisemaa tälle sivulle.
  • MCP-isäntä on poistettu käytöstä profiilin mukaan tarkoittaa, että tallennettu profiili on kytkenyt isännöinnin pois päältä.
  • MCP-isäntä ei käynnistynyt, koska mitään ilmoitettuja MCP-moduuleja ei ole käytössä tarkoittaa, että kaikki moduulikortit ovat pois käytöstä.
  • MCP-isäntä ei onnistunut käynnistymään tarkoittaa, että osoite, portti tai paikallinen ympäristö estivät käynnistymisen.

Lokialue antaa tarkan viestin epäonnistumisista ja hylätyistä pyynnöistä.

Turvallisuusmuistiinpanot

MCP-palvelin käyttää selkeää paikallista HTTP:ta sekä bearer-token-valtuutusta. Token suojaa pyyntöpolkua, mutta yhteys ei ole salattu. Käytä silmukointia samaan tietokoneeseen yhdistyville asiakkaille aina kun mahdollista. Käytä LAN-sidontaa vain verkoissa ja koneissa, joihin luotat.

Uudelleenluo token, jos se on jaettu asiakkaalle, jota et enää luota. Tokenin uudelleenluomisen jälkeen pysäytä ja käynnistä MCP-palvelin, jotta asiakkaat joutuvat käyttämään uutta arvoa.

Vianetsintä

Jos Aloita on poistettu käytöstä:

  • Ota käyttöön vähintään yksi moduuli.
  • Varmista, että Osoite ei ole tyhjää.
  • Varmista, että Portti on välillä 1 ja 65535.
  • Varmista, että Bearer-token ei ole tyhjää.
  • Pysäytä palvelin ennen Osoitteen, Portin tai Bearer-tokenin muuttamista.

Jos Aloita epäonnistuu:

  • Toinen prosessi saattaa jo käyttää porttia.
  • Osoite ei ehkä ole määritetty tälle tietokoneelle.
  • Valitse toinen portti tai osoite ja yritä uudelleen.
  • Tarkista Lokista tarkka epäonnistumisviesti.

Jos asiakas ei voi yhdistyä:

  • Varmista, että palvelin näyttää Käynnistetty.
  • Varmista, että asiakas-URL vastaa tarkasti Konfiguroitua päätettä.
  • Käytä 127.0.0.1 vain asiakkaille, jotka ovat samalla tietokoneella.
  • Toiselle LAN-tietokoneelle käytä tämän tietokoneen LAN IPv4 -osoitetta ja varmista, että palomuurisäännöt sallivat yhteyden.
  • Varmista, että asiakas tukee Streamable HTTP MCP:tä, ei vain stdio MCP:tä.

Jos asiakas vastaanottaa 401 Unauthorized:

  • Lisää Authorization -otsikko.
  • Varmista, että otsikko alkaa Bearer :llä.
  • Varmista, että token ei ole tyhjää.

Jos asiakas vastaanottaa 403 Forbidden:

  • Varmista, että token vastaa tarkasti nykyistä Bearer-tokenia.
  • Jos olet uudelleenluonut tokenin, päivitä asiakas.
  • Jos pyyntö sisältää Origin-otsikon, varmista, että se tulee sallitusta paikallisesta alkuperästä.

Jos asiakas vastaanottaa 405 Method Not Allowed:

  • Asiakas käyttää todennäköisesti HTTP GET.
  • Määritä asiakas Streamable HTTP -työkalukutsuille, jotka lähettävät POST /mcp.

Jos odotettuja työkaluja ei näy:

  • Varmista, että vastaava moduulikortti on Käytössä.
  • Pysäytä ja Käynnistä MCP-palvelin moduulin käytön muuttamisen jälkeen.
  • Varmista, että asiakas on päivittänyt tai yhdistänyt uudelleen palvelimen käynnistyksen jälkeen.