Extentos MCP

MCP सर्वर

MCP सर्वर

Extentos MCP सर्वर (@extentos/mcp-server\) एक npm पैकेज है जिसे एक AI एजेंट (Claude Code, Cursor, Windsurf, Cline) एक बार इंस्टॉल करता है और फिर इसका उपयोग किसी नेटिव iOS या Android ऐप में Meta Ray-Ban स्मार्ट-ग्लास क्षमताओं को जोड़ने के लिए करता है। यह 10 श्रेणियों — खोज, जनरेशन, एजेंट कॉन्फ़िगरेशन, क्रेडेंशियल्स, एनालिटिक्स, मार्गदर्शन, सत्यापन, सिमुलेशन, प्रोडक्शन-रेडीनेस, और दस्तावेज़ीकरण — में नियतात्मक उपकरणों का एक सघन सेट प्रस्तुत करता है, साथ ही खाता लिंकिंग, टेलीमेट्री सहमति और अपडेट जाँच के लिए एक CLI भी प्रदान करता है। यह एजेंट का संचालन मैनुअल है।

MCP सर्वर वह माध्यम है जिसके द्वारा एक AI एजेंट — Claude Code, Cursor, Windsurf, Cline, या कोई भी Model Context Protocol-संगत होस्ट — Extentos का संचालन करता है। एजेंट नियतात्मक उपकरणों का आह्वान करता है; सर्वर एजेंट को बताता है कि ग्लास कौन सी क्षमताएँ प्रस्तुत करते हैं, Kotlin और Swift में कैनोनिकल SDK कोड पैटर्न लौटाता है, प्रोजेक्ट को स्कैफोल्ड करता है, सिम्युलेटर सत्रों की दलाली करता है, और डिबगिंग ट्रेस क्वेरी करता है। सर्वर में स्वयं कोई नियोजन उपकरण नहीं है — एजेंट रेगेक्स बंडलों से बेहतर योजनाकार होते हैं। उपकरण टाइप किए गए प्रिमिटिव हैं जिन्हें एजेंट अनुक्रम में संयोजित करता है।

यह पृष्ठ अनुभाग लैंडिंग है — सर्वर क्या है, उपकरण एक नज़र में, कैनोनिकल एजेंट-संचालित प्रवाह, कॉन्फ़िगरेशन नॉब, CLI, और प्रमाणीकरण मॉडल कैसे काम करता है। उप-पृष्ठ प्रत्येक को गहराई से कवर करते हैं।

इंस्टॉल करें

claude mcp add extentos -- npx -y @extentos/mcp-server@latest

गैर-Claude-Code होस्ट के लिए, एजेंट प्रॉम्प्ट या मैन्युअल JSON इंस्टॉल पथ देखें। पूर्ण इंस्टॉल संदर्भ /docs/mcp-server/install पर है।

उपकरण, श्रेणी के अनुसार

सर्वर एक नियतात्मक उपकरण सतह प्रस्तुत करता है (mcp-server/src/tools/definitions.ts में सत्यापित), जो 10 श्रेणियों में व्यवस्थित है। श्रेणियाँ एजेंट का मानसिक मानचित्र हैं; एक एजेंट जो समझता है कि कोई उपकरण किस श्रेणी में रहता है, वह तय कर सकता है कि उसे कब कॉल करना है। हमेशा-वर्तमान पूर्ण कैटलॉग जनरेटेड टूल्स संदर्भ है।

1. खोज और SDK संदर्भ (3 उपकरण)

किसी भी नए कार्य में पहली कॉल। सस्ते, सभी स्थानीय, कोई दुष्प्रभाव नहीं।

उपकरण	यह क्या करता है
getPlatformInfo	स्थैतिक प्लेटफ़ॉर्म कैटलॉग लौटाता है — लाइब्रेरी संस्करण, ग्लास द्वारा प्रस्तुत SDK क्षमताओं की सूची, प्रति-विक्रेता स्तर। हमेशा सही पहली कॉल।
getCapabilityGuide	Kotlin + Swift में प्रति-सुविधा न्यूनतम उपयोग — कॉल आकार, कॉन्फ़िगरेशन आर्ग, गड़बड़ियाँ। getPlatformInfo (जो सुविधाओं का नाम बताता है) के साथ जोड़ी बनाकर एजेंट को बताता है कि प्रत्येक का आह्वान कैसे करें।
getCodeExample	दोनों भाषाओं में पूर्ण कैनोनिकल रचनाएँ। assistant_agent_loop (चरण-4 कैनोनिकल वॉयस-असिस्टेंट प्रवाह) और agent_driven_e2e_full_loop (एजेंट-संचालित E2E परीक्षण) से शुरू करें। voice_qa_assistant, barge_in_speak, photo_describe_voice, live_transcription_ui, voice_notes, connection_page_setup, byok_anthropic, display_browse_detail, display_media_gallery, और video_frames_ml को भी कवर करता है। हैंडलर कोड लिखते समय इनसे प्राप्त करें। पूर्ण प्रगणित सूची /docs/reference/mcp-tools पर जनरेट की गई है।

2. सेटअप और जनरेशन

उपकरण	यह क्या करता है
generateConnectionModule	वन-शॉट स्कैफोल्ड — बूटस्ट्रैप मॉड्यूल, Gradle/SPM वायरिंग, निर्भरताएँ, अनुमतियाँ, मैनिफ़ेस्ट। दो-कॉल प्रवाह: प्लेसमेंट के बिना पहली कॉल एक प्रश्न लौटाती है जो पूछता है कि ExtentosConnectionPage कहाँ रहना चाहिए; चुने हुए प्लेसमेंट के साथ दूसरी कॉल पूर्ण फ़ाइल सेट लौटाती है।
getConnectionPageConfig / setConnectionPageConfig	प्रति-प्रोजेक्ट कनेक्शन-पेज कॉन्फ़िगरेशन (थीमिंग टोकन + अनुभाग दृश्यता) पढ़ें / लिखें जो डैशबोर्ड/सर्वर धारण करता है।
regenerateConnectionPageFile / adoptConnectionPageFile	कमिटेड extentos.connection-page.json को सर्वर कॉन्फ़िगरेशन के साथ सिंक करें — पुनर्जीवित करें (सर्वर→फ़ाइल) या अपनाएँ (फ़ाइल→सर्वर)।

स्कैफोल्डिंग के बाद, एजेंट getCapabilityGuide / getCodeExample द्वारा प्रस्तुत SDK प्रिमिटिव के विरुद्ध अपनी स्वयं की हैंडलर कक्षाएँ लिखता है। हैंडलर कोड ग्राहक की ऑथरिंग सतह है — कोई initSpec या DSL-जनसंख्या चरण नहीं है।

3. एजेंट कॉन्फ़िगरेशन और उपयोग (3 उपकरण)

खाता-स्कोप्ड — एक लिंक किए गए खाते की आवश्यकता होती है और MCP एक्सेस ग्रांट (डिफ़ॉल्ट पढ़ें+लिखें) द्वारा प्रति-प्रोजेक्ट गेटेड होते हैं।

उपकरण	यह क्या करता है
getAssistantConfig / setAssistantConfig	किसी प्रोजेक्ट की डैशबोर्ड-प्रबंधित असिस्टेंट सेटिंग्स पढ़ें या बदलें — OpenAI Realtime मॉडल, आवाज़, मेमोरी (संघनन) मॉडल, और सत्र के भीतर मेमोरी मोड। set एक आंशिक अपडेट है, कैटलॉग के विरुद्ध प्रत्येक मान को मान्य करता है, और मॉडल परिवर्तन के लागत प्रभाव को प्रतिध्वनित करता है।
getGatewayUsage	प्रोजेक्ट का प्रबंधित-गेटवे उपयोग + हाल की अवधि में सटीक लागत पढ़ें — बिलिंग लेज़र से टोकन गणना और सूची-मूल्य USD, मॉडल द्वारा विभाजित। केवल मेटाडेटा, कभी भी ट्रांसक्रिप्ट या सामग्री नहीं।

4. क्रेडेंशियल्स (2 उपकरण)

खाता-स्कोप्ड + प्रति-प्रोजेक्ट गेटेड। बिना-जाने-लिखें — रहस्य कभी भी एजेंट के माध्यम से नहीं गुजरता।

उपकरण	यह क्या करता है
getCredentialStatus	पढ़ें कि क्या किसी प्रोजेक्ट की OpenAI API कुंजी (BYOK) और Meta DAT बिल्ड पहचान सेट है — एक नकाबपोश संकेत + केवल अपडेट-एट, मान कभी नहीं।
setCredential	किसी क्रेडेंशियल की बिना-जाने-लिखें प्रविष्टि शुरू करें — एक डैशबोर्ड लिंक लौटाता है जहाँ साइन-इन किया हुआ मालिक रहस्य को सीधे एन्क्रिप्टेड वॉल्ट में पेस्ट करता है। डिज़ाइन द्वारा कोई गुप्त तर्क नहीं लेता।

5. एनालिटिक्स (1 उपकरण)

उपकरण	यह क्या करता है
getProjectAnalytics	किसी प्रोजेक्ट के प्रोडक्शन एनालिटिक्स पढ़ें — शिप किए गए App Store / Play Store इंस्टॉल से समग्र टेलीमेट्री (ईवेंट, सक्रिय इंस्टॉल, ईवेंट / दिन / विक्रेता / प्लेटफ़ॉर्म द्वारा)। केवल मेटाडेटा, खाता-स्कोप्ड, स्वामित्व-जाँचा गया, एनालिटिक्स ग्रांट द्वारा गेटेड। ऐप के शिप होने और प्रोड-अटेस्टेड ईवेंट भेजने तक खाली (लाइव dev/sim स्ट्रीम के लिए getEventLog का उपयोग करें)।

6. कार्यान्वयन मार्गदर्शन (2 उपकरण)

साइड-क्वेस्ट उपकरण जिन्हें एजेंट रचना के दौरान कॉल करता है।

उपकरण	यह क्या करता है
getVoiceCommandGuidance	glasses.audio.transcriptions() उपभोक्ता में वायर करने से पहले UX मुद्दों (टकराव, अस्पष्टता, पहचानने में कठिन शब्द, Meta वेक-वर्ड विरोध) के लिए प्रस्तावित वेक / कमांड वाक्यांशों का विश्लेषण करें।
getPermissions	क्षमता सूची से सटीक प्लेटफ़ॉर्म अनुमतियाँ, Meta DAT आवश्यकताएँ, और अग्रभूमि-सेवा आवश्यकताएँ प्राप्त करें। अपने हैंडलर से कोई प्रिमिटिव जोड़ते या हटाते समय चलाएँ।

7. सत्यापन (2 उपकरण)

शुद्धता द्वार। संरचनात्मक परिवर्तनों (नई क्षमता घोषित, निर्भरता बढ़ाई गई, मैनिफ़ेस्ट संपादित) के बाद चलाएँ।

उपकरण	यह क्या करता है
inspectIntegration	केवल-पठनीय प्रोजेक्ट स्नैपशॉट — मैनिफेस्ट, जनरेटेड-फ़ाइल हैश, निर्भरता सूची, कनेक्शन-पेज कॉन्फ़िग। वर्तमान स्थिति समझने के लिए मैन्युअल संपादन से पहले चलाएँ।
validateIntegration	संपूर्ण-प्रोजेक्ट शुद्धता जाँच — मैनिफेस्ट, जनरेटेड फ़ाइलें, निर्भरता घोषित, अनुमतियाँ घोषित क्षमताओं को कवर करती हैं, बूटस्ट्रैप ExtentosGlasses.create(...) को कॉल करता है, टूलचेन संस्करण, सतत-कैप्चर प्रवाह के लिए फ़ोरग्राउंड-सेवा संकेत। प्री-टेस्ट गेट।

8. सिमुलेशन

ब्राउज़र-आधारित सिम्युलेटर सत्र प्रावधान और संचालित करें, साथ ही एजेंट-संचालित परीक्षण उपकरण जो बिना किसी मानव के एंड-टू-एंड लूप को बंद करते हैं।

उपकरण	यह क्या करता है
createSimulatorSession	extentos.com/s पर ब्राउज़र-मोड सत्र प्राप्त करें या बनाएँ। यदि इस प्रोजेक्ट के लिए कोई मौजूद है तो सहेजा गया सिम लौटाता है (स्थिति: "resumed"), या एक नया बनाता है (स्थिति: "active")। पहुँच योग्य होने पर स्थानीय ब्रिज के माध्यम से चल रहे ऐप को स्वतः संलग्न करता है; अन्यथा BuildConfig.EXTENTOS_SESSION_URL स्निपेट (Android) या extentos.session.plist पेलोड (iOS) उत्सर्जित करता है। साफ स्लेट के लिए sessionId घुमाने हेतु resetFresh: true पास करें।
ensureSimulatorBrowser	एक कनेक्टेड सिम्युलेटर ब्राउज़र टैब खोलें + पुष्टि करें — कैमरा और इंजेक्ट प्रवाह के लिए पूर्व शर्त।
completeAuthLink	createSimulatorSession द्वारा स्थिति: "auth_required" लौटाने के बाद (अनाम इंस्टॉल को मिंट सत्रों से लिंक करने की आवश्यकता है), बैकएंड को तब तक पोल करता है जब तक उपयोगकर्ता साइनअप पूरा नहीं कर लेता, फिर बियरर टोकन को ~/.extentos/auth.json में स्थायी करता है।
getEventLog	एक सत्र से संरचित ईवेंट ट्रेस प्राप्त करें। फ़िल्टर मान: all (कोई फ़िल्टर नहीं) और सात चिप्स errors, voice, camera, display, ai, lifecycle, custom — प्रति ईवेंट एक चिप, जिसमें errors मोडैलिटी की परवाह किए बिना गंभीरता≥चेतावनी को अवशोषित करता है। साथ ही ट्रेस-स्तरीय दायरे के लिए cursor, follow, limit। प्राथमिक डिबगिंग उपकरण।
getSimulatorStatus	एक लाइव सत्र की वर्तमान स्थिति पढ़ें — चरण, हार्डवेयर-तैयार, संलग्न भूमिकाएँ, सक्रिय क्षमता स्ट्रीम, वर्तमान टॉगल मान।
injectTranscript / injectAssistantUtterance / assertToolCalled	एक वेक फ़्रेज़ या असिस्टेंट टर्न चलाएँ, फिर दावा करें कि मॉडल ने कौन सा उपकरण कॉल किया — एजेंट-संचालित E2E लूप, किसी मानव की आवश्यकता नहीं।
setSimVideo / setSimDevice	एक परीक्षण वीडियो को सिम्युलेटेड कैमरे में पाइप करें; सिम्युलेटेड डिवाइस मॉडल स्विच करें (जैसे डिस्प्ले पथ का अभ्यास करने के लिए rayban_display)।
getDisplayState / injectInput	वर्तमान में रेंडर किए गए डिस्प्ले ट्री को पढ़ें + डिस्प्ले इनपुट चलाएँ (चयन / नेविगेट / वापस)।

9. उत्पादन (2 उपकरण)

प्री-शिप जाँच।

उपकरण	यह क्या करता है
getProductionChecklist	घोषित क्षमताओं + हैंडलर नामों के आधार पर वैयक्तिकृत उत्पादन-तत्परता चेकलिस्ट — क्रेडेंशियल वायरिंग, अनुमति ऑडिट, फ़ोरग्राउंड-सेवा आवश्यकताएँ (जब सतत कैप्चर का उपयोग किया जाता है), रिलीज़ बिल्ड से सिम्युलेटर-URL हटाना, स्टोर-लिस्टिंग तत्परता।
getCredentialGuide	उत्पादन AI प्रदाताओं के लिए चरण-दर-चरण क्रेडेंशियल सेटअप — anthropic, openai, google_cloud_vision, google_translate, google_gemini, deepl, azure_cognitive, aws_bedrock, huggingface, या custom — और Meta DAT पंजीकरण।

10. दस्तावेज़ीकरण और खोज (1 उपकरण)

उपकरण

यह क्या करता है

searchDocs

विषय या कीवर्ड द्वारा Extentos दस्तावेज़ खोजें। वॉइस असिस्टेंट के लिए पहले assistant_runtime पढ़ें; conversation_runtime पदावनत चरण-3 रनटाइम है (केवल माइग्रेशन संदर्भ)। अन्य संरेखित विषय: voice_integration, agent_e2e_testing, managed_gateway, conversation_memory, display, साथ ही स्थिर अवधारणात्मक सेट — getting_started, custom_handlers (विहित SDK-रचना दस्तावेज़), simulator_browser_mode, event_log_schema, toggles, library_api, permissions, multi_platform_projects। विषय IDs स्थिर हैं; लाइव उपकरण इनपुट आधिकारिक है।

इनपुट स्कीमा, प्रतिक्रिया आकार और काम किए गए उदाहरणों के साथ पूर्ण प्रति-उपकरण संदर्भ: /docs/mcp-server/tools।

विहित एजेंट-संचालित प्रवाह

एक ताज़ा प्रोजेक्ट में, एजेंट इस क्रम में उपकरणों का आह्वान करता है:

1. getPlatformInfo({ sections: ["version", "capabilities"], glasses: "meta_rayban" })
2. getCodeExample({ pattern: "assistant_agent_loop" })  // Phase-4 voice assistant; or whatever pattern fits
3. getCapabilityGuide({ feature: "<each primitive the handler will use>" })
4. generateConnectionModule({ platform, glasses, appPackage })
   → returns "needs_placement" question
5. generateConnectionModule({ ... placement: "<chosen>" })
   → writes scaffold files (ExtentosBootstrap, manifest, etc.)
6. <agent writes handler class(es)> against the SDK primitives
   <agent updates extentos.manifest.json's `capabilities` array>
7. validateIntegration()
   → ✓ all good (or returns structured errors to fix)
8. createSimulatorSession({ glasses })
   → returns sessionId; auto-opens browser at extentos.com/s/<id>
   → if running app is reachable via local bridge, it auto-attaches
9. <developer interacts with the simulator; capability events flow into the backend>
10. getEventLog({ sessionId, filter: "errors" })  → debug
    getSimulatorStatus({ sessionId })             → status

पुनरावृत्ति के लिए: हैंडलर कोड संपादित करें → पुनर्निर्माण + पुनर्स्थापित करें → ऐप स्वतः उसी सिम्युलेटर सत्र से जुड़ जाता है (कोई रीमिंट नहीं, URL स्थिर है)। शिपिंग से पहले: getProductionChecklist और getCredentialGuide।

कॉन्फ़िगरेशन

MCP सर्वर इन पर्यावरण चरों को पढ़ता है (mcp-server/src/ में सत्यापित):

चर	डिफ़ॉल्ट	यह क्या करता है
EXTENTOS_BACKEND_URL	उत्पादन बैकएंड	बैकएंड URL को ओवरराइड करें (tools/util/backendClient.ts)। स्वयं Extentos के स्थानीय विकास के लिए।
EXTENTOS_CONFIG_DIR	~/.extentos	कॉन्फ़िग/प्रमाणीकरण निर्देशिका को ओवरराइड करें (telemetry/consent.ts)।
EXTENTOS_TELEMETRY	अनसेट (सहमति-डिफ़ॉल्ट)	CLI सहमति कमांड चलाए बिना टेलीमेट्री अस्वीकार करने के लिए 0 पर सेट करें।
EXTENTOS_NO_AUTO_OPEN	अनसेट	सिम्युलेटर-सत्र निर्माण पर ब्राउज़र ऑटो-ओपन अक्षम करने के लिए 1 पर सेट करें (हेडलेस वातावरण में उपयोगी)।

पूर्ण कॉन्फ़िगरेशन संदर्भ: /docs/mcp-server/configuration।

CLI उपकमांड

बिना किसी तर्क के npx @extentos/mcp-server@latest चलाने से stdio पर MCP सर्वर शुरू होता है (वह पथ जो एजेंट उपयोग करता है)। एक उपकमांड के साथ, यह एक डेवलपर CLI के रूप में कार्य करता है:

उपकमांड	यह क्या करता है
login	डिवाइस-कोड प्रवाह के माध्यम से इस इंस्टॉल को Extentos खाते से लिंक करें (सक्रिय — पहले सिम्युलेटर सत्र से पहले, या पुनः लिंक करने के लिए लॉगआउट के बाद उपयोगी)।
logout	~/.extentos/auth.json साफ़ करें। इंस्टॉल अनाम स्तर पर लौट आता है; अगला सिम्युलेटर सत्र कॉल डिवाइस-कोड प्रवाह को फिर से ट्रिगर करेगा।
whoami	अभी तक कार्यान्वित नहीं (चरण-0 स्टब)। installId, accountId (यदि लिंक किया गया), स्तर, auth समाप्ति प्रिंट करेगा।
setup	स्थानीय बिल्ड वातावरण की पूर्व-जांच करें — GitHub पैकेज PAT (read:packages) की जाँच करता है जिसकी सकर्मक Meta DAT कलाकृतियों को आवश्यकता होती है, साथ ही अन्य निर्भरता पूर्वापेक्षाएँ।
accept-privacy	गोपनीयता सहमति रिकॉर्ड करें (टेलीमेट्री अपलोड सक्षम करता है)।
decline-privacy	गोपनीयता अस्वीकृति रिकॉर्ड करें (टेलीमेट्री अपलोड अक्षम करता है)।
status	सहमति स्थिति, इंस्टॉल आईडी, लिंक किया गया खाता, MCP/लाइब्रेरी संस्करण प्रिंट करें।
update	MCP सर्वर अपडेट की जाँच करें (npx @latest इंस्टॉल पर नो-ऑप)।

पूर्ण CLI संदर्भ: /docs/mcp-server/auth.

प्रमाणीकरण मॉडल

MCP सर्वर अनाम-प्रथम है। खोज, क्षमता मार्गदर्शिकाएँ, कोड उदाहरण, सत्यापन, दस्तावेज़ खोज, ऑन-डिवाइस सिमुलेशन, और वास्तविक-हार्डवेयर परीक्षण सभी बिना साइन इन किए काम करते हैं। तीन चीजें एक मुफ़्त खाते को लिंक करती हैं: ब्राउज़र-सिम्युलेटर सत्र बनाना (createSimulatorSession, HTTP 402), generateConnectionModule स्कैफोल्ड चरण (यह आपकी खाता-बद्ध प्रोजेक्ट कुंजी बनाता है — वही 402 डिवाइस-कोड प्रवाह; सूचनात्मक पहला कॉल अनाम होता है), और खाता-स्कोप्ड प्रोजेक्ट उपकरण (सहायक कॉन्फ़िग, क्रेडेंशियल, कनेक्शन-पेज राइट, एनालिटिक्स — HTTP 401)।

डिवाइस-कोड प्रवाह: पहला गेटेड कॉल एक सत्यापन URL के साथ status: "auth_required" लौटाता है। एजेंट बैकएंड को पोल करने के लिए completeAuthLink कॉल करता है; डेवलपर URL पर एक मुफ़्त केवल-ईमेल खाते से साइन अप करता है (Google या ईमेल + पासवर्ड, कोई भुगतान नहीं); बैकएंड एक टोकन जारी करता है; मूल उपकरण कॉल स्वचालित रूप से पुनः प्रयास करता है। लिंक करने के बाद, सिम्युलेटर सत्र असीमित हैं।

Extentos के उपकरण, कोडजेन, सत्यापन, SDK, और ब्राउज़र सिम्युलेटर मुफ़्त हैं — बनाने और शिप करने के लिए कोई प्रति-सीट या सदस्यता शुल्क नहीं है। एकमात्र सतह जो उपयोग को मापती है वह चरण-4 ध्वनि सहायक के पीछे प्रबंधित AI गेटवे है। पूर्ण प्रमाणीकरण मॉडल: /docs/mcp-server/auth; मूल्य निर्धारण: /docs/resources/pricing.

गोपनीयता और टेलीमेट्री

पहले रन पर, MCP सर्वर प्रतिक्रिया में एक बार की गोपनीयता सूचना इंजेक्ट करता है। टेलीमेट्री अनाम है (installId के साथ टैग की गई, कोई स्रोत कोड या व्यक्तिगत डेटा नहीं) और डिफ़ॉल्ट रूप से जारी रखने पर खारिज कर दी जाती है — Vercel CLI, Astro, Vite के समान पैटर्न। किसी भी समय अस्वीकार करें:

npx @extentos/mcp-server@latest decline-privacy
# or
EXTENTOS_TELEMETRY=0 (env var, persistent for the shell)

गोपनीयता सूचना सामग्री mcp-server/src/index.ts (PRIVACY_NOTICE स्थिरांक) में है। सूचना claimFirstPrivacyNotice के माध्यम से प्रति इंस्टॉल एक बार दिखाई जाती है — कभी दोहराई नहीं जाती।

संगत MCP होस्ट

इनके साथ काम करने के लिए सत्यापित:

• Claude Code — प्राथमिक लक्ष्य। claude mcp add के माध्यम से एक-पंक्ति इंस्टॉल।
• Cursor — ~/.cursor/mcp.json में JSON कॉन्फ़िग।
• Windsurf — ~/.codeium/windsurf/mcp_config.json में JSON कॉन्फ़िग।
• Cline — Cline की MCP सेटिंग्स में JSON कॉन्फ़िग।
• कोई भी MCP-संगत होस्ट — मानक mcpServers.extentos JSON ब्लॉक डालें।

MCP सर्वर stdio (@modelcontextprotocol/sdk) पर मानक MCP प्रोटोकॉल बोलता है; सर्वर साइड पर कोई होस्ट-विशिष्ट कोड पथ मौजूद नहीं है। प्रति-होस्ट इंस्टॉल चरण: /docs/mcp-server/agents.

स्थानीय ब्रिज — ऑटो-बाइंड डेव लूप

जब सर्वर शुरू होता है, तो यह एक 127.0.0.1:31337/whoami HTTP श्रोता (mcp-server/src/localBridge.ts) खोलता है। डेवलपर के ऐप पर Extentos लाइब्रेरी रनटाइम पर इस एंडपॉइंट की जाँच करती है ताकि इसके होस्ट MCP का installId सीख सके। परिणाम: एजेंट से प्रत्येक createSimulatorSession कॉल स्वचालित रूप से चल रहे ऐप को नए सत्र से जोड़ता है — कोई रीबिल्ड नहीं, कोई URL पेस्ट नहीं।

पहुँच पथ:

• Android एमुलेटर: http://10.0.2.2:31337/whoami (होस्ट-लूपबैक NAT उपनाम)
• iOS सिम्युलेटर: http://localhost:31337/whoami (होस्ट नेटवर्क नेमस्पेस साझा करता है)
• USB के माध्यम से भौतिक Android फ़ोन: एक बार adb reverse tcp:31337 tcp:31337, फिर डिवाइस से localhost:31337
• सेल्युलर फ़ोन या क्लाउड-होस्टेड एजेंट: जाँच का समय समाप्त। एजेंट इसके बजाय URL-बेक पथ का उपयोग करता है — createSimulatorSession एक BuildConfig.EXTENTOS_SESSION_URL स्निपेट (Android) या extentos.session.plist पेलोड (iOS) लौटाता है जिसे डेवलपर पेस्ट करता है, फिर ऐप को एक बार रीबिल्ड करता है। ऑटो-बाइंड से कम सुरुचिपूर्ण लेकिन किसी भी टोपोलॉजी पर काम करता है।

केवल 127.0.0.1 से बंधा हुआ। installId कोई रहस्य नहीं है — यह वही मान है जो MCP प्रत्येक उपकरण कॉल पर api.extentos.com को भेजता है। इस परत पर किसी प्रमाणीकरण की आवश्यकता नहीं है।

यदि पोर्ट 31337 उपयोग में है (दुर्लभ; एक और MCP इंस्टेंस पहले से चल रहा है), स्टार्टअप एक चेतावनी लॉग करता है और जारी रखता है। उस सत्र के लिए ऑटो-बाइंड चुपचाप विफल हो जाता है; डेवलपर पोर्ट मुक्त होने तक URL-बेक पथ का उपयोग करता है।

स्थिति

• पैकेज: npm पर @extentos/mcp-server (MIT लाइसेंस)
• इंजन: Node.js 20+
• पूर्व-1.0 — हार्डवेयर परीक्षण लूप बंद होने तक API छोटे संस्करणों के बीच बदल सकते हैं। यदि आपको क्रॉस-सत्र पुनरुत्पादकता की आवश्यकता है तो एक सटीक संस्करण पर पिन करें।

संबंधित

• AI एजेंट के साथ त्वरित शुरुआत — सर्वर स्थापित करें और एक वास्तविक डेव लूप के माध्यम से चलें
• उपकरण संदर्भ — पूर्ण प्रति-उपकरण API
• कॉन्फ़िगरेशन — पर्यावरण चर, कॉन्फ़िग फ़ाइलें, इंस्टॉल-समय सेटिंग्स
• प्रमाणीकरण — डिवाइस-कोड प्रवाह, खाता लिंकिंग, CLI प्रमाणीकरण कमांड
• समर्थित एजेंट — प्रति-होस्ट इंस्टॉल निर्देश
• आर्किटेक्चर — MCP सर्वर व्यापक Extentos सिस्टम में कैसे फिट बैठता है
• ट्रांसपोर्ट बनाम ऐप सिमुलेशन — MCP जिस सिम्युलेटर को ब्रोकर करता है वह वास्तव में क्या करता है

संबंधित

AI एजेंट के साथ त्वरित शुरुआत

Extentos MCP सर्वर स्थापित करें और अपने AI एजेंट को Meta Ray-Ban स्मार्ट-ग्लास क्षमताओं को एक मूल iOS या Android ऐप में स्कैफोल्ड करने दें। शुरू करने के लिए मुफ़्त।

आर्किटेक्चर

Extentos एक साथ कैसे फिट बैठता है — AI एजेंट, MCP सर्वर, मूल Kotlin/Swift SDK, तीन ट्रांसपोर्ट (Meta DAT, ब्राउज़र सिम, स्थानीय इन-मेमोरी सिम), और बैकएंड।

ट्रांसपोर्ट बनाम ऐप सिमुलेशन

Meta का मॉक डिवाइस किट ट्रांसपोर्ट लेयर का अनुकरण करता है; Extentos ऐप लेयर का अनुकरण करता है — आवाज़, फोटो कैप्चर, और पहनने का अनुभव। दोनों मायने रखते हैं।

MCP सर्वर स्थापित करें

किसी भी MCP-संगत AI कोडिंग एजेंट — Claude Code, Cursor, Windsurf, Cline, और अन्य में Extentos MCP सर्वर (@extentos/mcp-server) कैसे स्थापित करें। प्रति-होस्ट इंस्टॉल कमांड, कॉन्फ़िग फ़ाइल स्थान, कॉपी-पेस्ट करने योग्य JSON स्निपेट, पुनरारंभ और सत्यापन चरण, संस्करण पिनिंग, अपडेट करना, सामान्य त्रुटियों का निवारण, और अनइंस्टॉल निर्देश। प्रत्येक समर्थित होस्ट के लिए सत्यापित इंस्टॉल पथ।

उपकरण संदर्भ

Extentos MCP सर्वर नियतात्मक श्रेणियों में नियतात्मक उपकरणों का एक सघन सेट उजागर करता है — खोज + SDK संदर्भ, जनरेशन, मार्गदर्शन, सत्यापन, सिमुलेशन, उत्पादन, एजेंट कॉन्फ़िगरेशन, और खोज। इनपुट पैरामीटर, प्रतिक्रिया आकार, प्रत्येक उपकरण को कब कॉल करना है, और काम किए गए उदाहरणों को कवर करने वाला प्रति-उपकरण संदर्भ। @extentos/mcp-server में वास्तविक उपकरण परिभाषाओं और हैंडलर कार्यान्वयन से सत्यापित।

कॉन्फ़िगरेशन

@extentos/mcp-server कॉन्फ़िगर करें — पर्यावरण चर, ~/.extentos स्थिति फ़ाइलें (इंस्टॉल आईडी, प्रमाणीकरण, सहमति), और डिफ़ॉल्ट विक्रेता।

प्रमाणीकरण

Extentos प्रमाणीकरण कैसे काम करता है। लगभग सब कुछ बिना किसी खाते के चलता है; केवल ब्राउज़र सिम्युलेटर को OAuth 2.0 डिवाइस-कोड प्रवाह के माध्यम से साइन-इन की आवश्यकता होती है। कोई भुगतान नहीं।

समर्थित एजेंट

Extentos चलाने वाले AI कोडिंग एजेंटों के लिए प्रति-होस्ट अंतर — Claude Code, Cursor, Windsurf, Cline, IDE बिल्ट-इन। दायरा, क्रॉस-प्लेटफ़ॉर्म पहुँच, MCP समर्थन।

Apple स्मार्ट ग्लास

तृतीय-पक्ष डेवलपर्स के लिए Apple स्मार्ट ग्लास — SDK पहुँच, ऐप मॉडल, वितरण, क्षमताएँ और AI, और यह 2026 स्मार्ट-ग्लास परिदृश्य में कहाँ बैठता है।

MCP सर्वर स्थापित करें