Kamai MCP

npx add-mcp 'https://mcp.kamai.io/mcp'

kamai-mcp

Kamai का MCP सर्वर: Kamai निर्माण-ब्लूप्रिंट परियोजनाओं, ब्लूप्रिंट और टेकऑफ़ के लिए उपकरण और MCP ऐप्स विजेट। यह Kamai के MCP API के विरुद्ध चलता है और Kamai के OAuth प्राधिकरण सर्वर द्वारा जारी एक्सेस टोकन को मान्य करता है। इसमें Kamai का कोई गोपनीय डेटा नहीं होता।

उपकरण

उपकरण	यह क्या करता है
view_projects	उपयोगकर्ता की परियोजनाओं और ब्लूप्रिंट का इंटरैक्टिव पैनल
list_blueprints	परियोजना के अनुसार समूहीकृत ब्लूप्रिंट, उनके आईडी और वे तैयार हैं या नहीं
view_blueprint	एक ब्लूप्रिंट पृष्ठ जिस पर उसके टेक-ऑफ़ आकार खींचे गए हैं
view_takeoff	मापी गई टेक-ऑफ़ मात्राएँ एक क्रमबद्ध तालिका के रूप में
list_elements	प्रति-तत्व पंक्तियाँ (कमरे, दीवारें, दरवाजे, खिड़कियाँ, वस्तुएँ) रूपरेखा के साथ
list_folders	एक ब्लूप्रिंट के लीजेंड फ़ोल्डर
download_plan	एक संसाधित ब्लूप्रिंट का PDF जिसमें पहचाने गए तत्व हाइलाइट किए गए हैं, अस्थायी डाउनलोड लिंक के रूप में
update_elements, move_elements, create_folder	तत्वों का नाम बदलें, रंग बदलें और फ़ाइल करें; एक फ़ोल्डर बनाएँ
set_opening_height	दीवार-सतह के खुलने वाले टुकड़ों पर उपयोगकर्ता-बताई ऊँचाई, या दरवाज़ा/खिड़की टैग संग्रहीत करें
create_project, update_project	एक परियोजना बनाएँ या उसका नाम बदलें
list_jobs, get_job, cancel_job	एक परियोजना के प्रसंस्करण कार्य
view_upload	ब्लूप्रिंट PDF के लिए अपलोड पैनल
ingest_blueprint_from_chat	ChatGPT संदेश से जुड़ा PDF आयात करें (केवल ChatGPT)
open_kamai	Kamai ऐप को एक पैनल में खोलें

KAMAI_QUERY_TOOLS=on के साथ (नीचे देखें):

उपकरण	यह क्या करता है
count_elements	Kamai श्रेणी (दरवाजे, खिड़कियाँ, दीवारें, गीले कमरे…) के अनुसार गणना और कुल, डेटाबेस में समूहीकृत और संक्षेपित
find_elements	प्रकार, फ़ोल्डर, टैग, हैंडिंग और माप के साथ व्यक्तिगत तत्व
calculate_wall_surface_area	कमरों का शुद्ध दीवार (पेंट या प्लास्टर) क्षेत्र
render_table	एक तालिका पैनल जिसकी पंक्तियाँ योजना पर अपने तत्वों को हाइलाइट करती हैं
set_scale	एक ब्लूप्रिंट का ड्राइंग स्केल सेट करें

list_blueprints भी include_inventory लेता है (एक project_id के साथ): प्रत्येक ब्लूप्रिंट में क्या है।

list_projects, get_project, get_blueprint, request_blueprint_upload, finalize_blueprint_upload, और क्वेरी उपकरणों get_table_row_elements और get_element_outlines के साथ, केवल ऐप-विशिष्ट हैं: विजेट द्वारा कॉल करने योग्य, मॉडल को विज्ञापित नहीं।

अपनी API कुंजी के साथ स्थानीय रूप से चलाएँ

इस सर्वर को अपने स्वयं के Kamai डेटा के विरुद्ध चलाने का सबसे तेज़ तरीका स्थानीय मोड है: होस्ट सर्वर को स्पॉन करता है, stdio पर उससे बात करता है, और क्रेडेंशियल Kamai से एक व्यक्तिगत API कुंजी है (Kamai ऐप में API कुंजियाँ) OAuth के बजाय।

bun install
bun run build:widgets
KAMAI_API_KEY=... MCP_API_BASE_URL=https://mcp-api.kamai.io bun run local

Claude Code:

claude mcp add --env KAMAI_API_KEY=... --env MCP_API_BASE_URL=https://mcp-api.kamai.io \
  --transport stdio kamai -- bun /path/to/kamai-mcp/src/local.ts

Claude Desktop (claude_desktop_config.json):

{ "mcpServers": { "kamai": {
    "command": "bun", "args": ["/path/to/kamai-mcp/src/local.ts"],
    "env": { "KAMAI_API_KEY": "...", "MCP_API_BASE_URL": "https://mcp-api.kamai.io" } } } }

कुंजी का उपयोग हर API कॉल के लिए बियरर के रूप में किया जाता है; उपकरण कुंजी के स्वामी के रूप में चलते हैं। क्वेरी उपकरणों के लिए पर्यावरण में KAMAI_QUERY_TOOLS=on जोड़ें।

HTTP सर्वर चलाएँ

bun install
cp .env.example .env
bun run dev

.env.example में मान प्लेसहोल्डर हैं: शुरू करने से पहले MCP_PUBLIC_URL और MCP_AUTH_ISSUER को अपनी टनल और एक पहुंच योग्य प्राधिकरण सर्वर पर सेट करें, अन्यथा हर अनुरोध invalid_token के साथ अस्वीकार कर दिया जाएगा।

चर	अर्थ
PORT	सुनने का पोर्ट, डिफ़ॉल्ट 8006
MCP_PUBLIC_URL	वह URL जिसे होस्ट कॉल करते हैं और टोकन माँगते हैं (डिस्कवरी में resource); एक टनल, localhost नहीं
MCP_AUTH_ISSUER	एक्सेस टोकन का जारीकर्ता, टोकन के iss के विरुद्ध बाइट-दर-बाइट मिलान किया गया
MCP_AUTH_JWKS_URI	वैकल्पिक। डिफ़ॉल्ट {MCP_AUTH_ISSUER}/jwks.json है
MCP_API_BASE_URL	Kamai MCP API आधार URL, https://mcp-api.kamai.io। यह भी वह दर्शक है जिसे एक्सेस टोकन को ले जाना चाहिए
MCP_ACCEPTED_AUDIENCES	वैकल्पिक अल्पविराम-पृथक दर्शक, कटओवर के लिए। डिफ़ॉल्ट MCP_API_BASE_URL है
KAMAI_API_KEY	केवल स्थानीय मोड: व्यक्तिगत API कुंजी जिसके रूप में उपकरण चलते हैं
KAMAI_APP_ORIGINS	वैकल्पिक अल्पविराम-पृथक अतिरिक्त मूल जिन्हें open_kamai फ्रेम कर सकता है; पहला डिफ़ॉल्ट बन जाता है
KAMAI_QUERY_TOOLS	on क्वेरी उपकरण पंजीकृत करता है। https://mcp-api.kamai.io उन्हें परोसता है; इसे बंद रखें ऐसे API के विरुद्ध जो /v1/vocabulary को 404 के साथ उत्तर देता है
KAMAI_MCP_NO_INSTRUCTIONS	1 सर्वर निर्देशों को बाहर छोड़ देता है, जैसा claude.ai करता है, उपकरण विवरणों का अकेले परीक्षण करने के लिए

MCP API और प्राधिकरण सर्वर Kamai द्वारा संचालित हैं, इसलिए HTTP सर्वर को अंत-से-अंत चलाने के लिए दोनों तक पहुंच की आवश्यकता होती है। एक MCP सर्वर वास्तव में केवल एक वास्तविक होस्ट के विरुद्ध परीक्षण योग्य है, और एक होस्ट केवल एक सार्वजनिक HTTPS URL तक पहुंच सकता है, इसलिए HTTP-मोड विकास का अर्थ है एक टनल के पीछे चलना और MCP_PUBLIC_URL को उस पर इंगित करना।

bun run dev पहले विजेट बनाता है: सर्वर dist/widgets/ से निर्मित HTML परोसता है, React स्रोत नहीं, इसलिए src/widgets/app/ के अंतर्गत कुछ भी छूने के बाद पुनर्निर्माण करें।

विजेट React, TypeScript, Vite, Tailwind CSS, DaisyUI और Lucide का उपयोग करते हैं। Vite प्रति विजेट एक स्व-निहित HTML संसाधन उत्पन्न करता है, इसलिए किसी होस्टिंग की आवश्यकता नहीं है।

स्थानीय निर्माण के लिए Bun 1.3.3 और Node.js 22.12 या नया संस्करण आवश्यक है।

लेआउट

src/index.ts       HTTP सर्वर, OAuth संरक्षित-संसाधन मेटाडेटा, MCP परिवहन
src/local.ts       स्थानीय मोड के लिए stdio प्रवेश बिंदु (व्यक्तिगत API कुंजी)
src/auth.ts        बियरर-टोकन सत्यापन (RFC 9728 चुनौतियाँ)
src/server.ts      उपकरण और संसाधन पंजीकरण
src/api.ts         Kamai MCP API के लिए क्लाइंट
src/elements.ts    list_elements पेजिंग, फ़िल्टरिंग और परिणाम बजट
src/errors.ts      वह पाठ जो एक असफल उपकरण कॉल मॉडल को दिखाता है
src/query/         क्वेरी उपकरण: विवरण, शब्दावली, फ़िल्टर, बजट, अनुबंध
src/widgets/       विजेट संसाधन, CSP मेटाडेटा और React विजेट स्रोत
scripts/           विजेट निर्माण (& को एस्केप करता है ताकि Open WebUI विजेट एम्बेड कर सके);
                   एक लाइव API के विरुद्ध check-routes और check-vocabulary
scripts/open-webui/
                   Open WebUI सहायक: एक open_kamai उपकरण, एक डिस्प्ले-मोड
                   होस्ट स्क्रिप्ट, एक स्थानीय ब्रिज डेमो

गोपनीयता और समर्थन

• गोपनीयता नीति: https://kamai.io/privacy-policy
• समर्थन: https://kamai.io/support या contact@kamai.io

योगदान

CONTRIBUTING.md देखें। सुरक्षा मुद्दे SECURITY.md में दिए गए पते पर जाते हैं, मुद्दा ट्रैकर पर नहीं।

लाइसेंस

Apache-2.0। कॉपीराइट 2026 Kamai Enterprises LTD।

Kamai नाम और लोगो Kamai Enterprises LTD के ट्रेडमार्क हैं और लाइसेंस द्वारा कवर नहीं हैं।