MCP Server

Altista valittujen sovellusten ominaisuudet paikallisille MCP-asiakkaille

MCP Server -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 paljastaa sovelluksen nimenomaisesti julkaisemmat alueen ominaisuudet. Se ei ole yleinen etäohjauspinta sovelluksen ikkunalle.

ControlMyNikonille ensimmäinen hyödyllinen moduuli on NikonMCP. NikonMCP on tarkoitettu Nikon-kameran tilan ja kameratoimintojen, kuten kuvauksen, live-näkymän, yhteyden hallinnan ja kontrastiautomaattitarkennuksen, hallintaan.

Käytä NikonMCP Nikon-spesifiseen työkalulistaan ja kameran tilatietoihin.

Sivun ohjaimet

  • Aloita alkaa isännöidä MCP-päätettä.
  • Pysäytä lopettaa MCP-päätteen ja vapauttaa portin.
  • Osoite asettaa paikallisen osoitteen, johon kuunnellaan.
  • Portti asettaa TCP-portin.
  • Määritetty päätepiste näyttää URL-osoitteen, joka annetaan MCP-asiakkaalle.
  • Kopioi URL kopioi määritetyn 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, kuten NikonMCP.
  • 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äätepiste 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 Server 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 silloin, 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 internetin suuntaisten palomuurisääntöjen kautta. MCP-työkalut voivat pyytää todellisia sovellustoimintoja, joten käsittele päätepistettä ja tokenia kuin paikallista ohjausavainta.

Yhdistä asiakas

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

  1. Päätepisteen URL: määritetty päätepiste, joka näkyy sivulla.
  2. Valtuutusotsikko: Authorization: Bearer your-token.

Useimmat asiakkaat pyytävä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 Server -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ä asiakkaan määrittämisessä tai vianetsinnässä.

Päätepiste 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 luettelo:

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

Kutsu työkalua:

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

Palvelin palauttaa jäsennellyt työkalutulokset. Odotetut sovelluksen hylkäykset, kuten kameran ei-yhteydessä oleminen, 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 Server tarkoittaa, että sivu on ladattu ja asetukset ovat käytettävissä.
  • MCP-isäntä käynnistyi tarkoittaa, että palvelin käynnistyi onnistuneesti.
  • MCP-isäntä pysähtyi tarkoittaa, että palvelin pysähtyi normaalisti.
  • Ei MCP-aikaisuutta ole rekisteröity tarkoittaa, että sovellus ei ilmoittanut MCP-aikaisuutta 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 Server 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 Server, 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 yhdistää:

  • Varmista, että palvelin näyttää Käynnistetty.
  • Varmista, että asiakas-URL vastaa tarkasti Määritettyä päätepistettä.
  • 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 Nikon-työkaluja ei näy:

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