Currents
आधिकारिकAI एजेंटों को Currents पर रिपोर्ट किए गए Playwright परीक्षण विफलताओं को ठीक करने में सक्षम बनाएँ।
Currents MCP के साथ आप क्या कर सकते हैं?
- विफल परीक्षणों का निदान करें —
currents-get-contextके माध्यम से विफल CI रन के पीछे की त्रुटियों, चरणों और फ़ाइलों को पूछकर समस्याओं को सीधे ठीक करें। - परीक्षण प्रदर्शन की समीक्षा करें —
currents-get-project-insightsका उपयोग करके किसी प्रोजेक्ट के लिए तिथि सीमा के भीतर एकत्रित रन और परीक्षण मेट्रिक्स प्राप्त करें। - क्वारंटाइन नियम प्रबंधित करें — परीक्षणों को प्रभावित करने वाली क्रियाओं को सूचीबद्ध, बनाएं, अपडेट करें, सक्षम या अक्षम करें, जैसे कि फ्लैकी स्पेक्स को क्वारंटाइन करना।
- परीक्षण साक्ष्य एकत्र करें — डिबगिंग या डेमो के लिए
currents-get-test-evidenceके साथ CI रन से स्क्रीनशॉट, वीडियो, ट्रेस और अटैचमेंट खींचें। - परिणाम बाहरी रूप से साझा करें —
currents-create-share-linkके माध्यम से बिना साइन इन किए किसी के लिए भी देखने हेतु परीक्षण परिणामों का एक सार्वजनिक, समाप्त होने वाला लिंक बनाएं। - Jira के साथ एकीकृत करें — अपने संगठन के Jira एकीकरण का उपयोग करके विफल रन परीक्षणों से सीधे Jira मुद्दे बनाएं या लिंक करें।
दस्तावेज़
Currents MCP सर्वर
अपने AI कोडिंग एजेंटों को अपने CI परीक्षण परिणामों की पूरी दृश्यता दें। Currents MCP सर्वर Cursor और Claude जैसे टूल्स को सीधे आपके Currents डैशबोर्ड से जोड़ता है, ताकि एजेंट फ्लैकी परीक्षणों का निदान कर सकें, विफलताओं को इंगित कर सकें, और वास्तविक निष्पादन डेटा पर कार्य कर सकें — बिना अपने एडिटर को छोड़े।
- CI से रन, स्पेक फ़ाइलें, और व्यक्तिगत परीक्षण परिणाम क्वेरी करें
- अपने परीक्षण सूट में त्रुटि प्रवृत्तियों और प्रदर्शन मेट्रिक्स को सतह पर लाएं
- क्वारंटाइन नियम, वेबहुक, और प्रोजेक्ट सेटिंग्स को प्रोग्रामेटिक रूप से प्रबंधित करें
- एजेंटों को वास्तविक परीक्षण आउटपुट का उपयोग करके जो टूटा है उसे ठीक करने दें, अनुमान से नहीं
टूल्स
| टूल | विवरण |
|---|---|
currents-list-actions | किसी प्रोजेक्ट के लिए सभी एक्शन सूचीबद्ध करें, वैकल्पिक फ़िल्टरिंग के साथ। |
currents-create-action | किसी प्रोजेक्ट के लिए नया एक्शन बनाएँ। |
currents-get-action | आईडी द्वारा एक एक्शन प्राप्त करें। |
currents-update-action | मौजूदा एक्शन अपडेट करें। |
currents-delete-action | एक एक्शन हटाएँ (आर्काइव करें)। |
currents-enable-action | अक्षम एक्शन सक्षम करें। |
currents-disable-action | सक्रिय एक्शन अक्षम करें। |
currents-list-affected-tests | किसी प्रोजेक्ट के लिए एक्शन से प्रभावित परीक्षणों (क्वारंटीन, स्किप, टैग) को तारीख सीमा के भीतर सूचीबद्ध करें। |
currents-get-affected-test-executions | एक परीक्षण पर आधारित: एक परीक्षण के उन निष्पादनों को सूचीबद्ध करता है जिन पर एक एक्शन लागू किया गया था, तारीख सीमा के भीतर, प्रत्येक के रन, ब्रांच और कमिट के साथ। |
currents-get-action-executions | एक एक्शन पर आधारित: उन परीक्षण निष्पादनों को सूचीबद्ध करता है जिन पर एक नियम लागू किया गया था, उन सभी परीक्षणों में जिन्हें उसने छुआ, तारीख सीमा के भीतर। |
currents-get-projects | Currents प्लेटफ़ॉर्म में उपलब्ध प्रोजेक्ट प्राप्त करता है। |
currents-get-project | आईडी द्वारा एक प्रोजेक्ट प्राप्त करें। |
currents-get-project-insights | किसी प्रोजेक्ट के लिए तारीख सीमा के भीतर एकत्रित रन और परीक्षण मेट्रिक्स प्राप्त करें। |
currents-list-pull-requests | किसी प्रोजेक्ट के लिए पुल-रिक्वेस्ट कार्ड सूचीबद्ध करें (रन meta.pr.id द्वारा समूहीकृत)। |
currents-list-project-terms | एक प्रकार (टैग, ब्रांच, authorName, आदि) के लिए कर्सर-पेजिनेटेड प्रोजेक्ट शर्तें सूचीबद्ध करें। |
currents-create-jira-issue | संगठन Jira एकीकरण का उपयोग करके रन परीक्षण से Jira मुद्दा बनाएँ। |
currents-link-jira-issue | संगठन Jira एकीकरण का उपयोग करके मौजूदा Jira मुद्दे को रन परीक्षण से लिंक करें। |
currents-list-jira-projects | संगठन एकीकरण के लिए उपलब्ध Jira प्रोजेक्ट सूचीबद्ध करें। |
currents-list-jira-issue-types | किसी Jira प्रोजेक्ट के लिए Jira मुद्दा प्रकार और कस्टम फ़ील्ड सूचीबद्ध करें। |
currents-get-runs | किसी विशिष्ट प्रोजेक्ट के लिए रन की सूची वैकल्पिक फ़िल्टरिंग के साथ प्राप्त करता है। |
currents-get-run-details | किसी विशिष्ट परीक्षण रन का विवरण प्राप्त करता है। |
currents-find-run | क्वेरी पैरामीटर द्वारा रन खोजें। |
currents-cancel-run | चल रहे रन को रद्द करें। |
currents-reset-run | पुनः निष्पादन की अनुमति देने के लिए रन में विफल स्पेक फ़ाइलें रीसेट करें। |
currents-delete-run | रन और सभी संबंधित डेटा हटाएँ। |
currents-cancel-run-github-ci | GitHub Actions वर्कफ़्लो रन आईडी और प्रयास संख्या द्वारा रन रद्द करें। |
currents-get-spec-instance | instanceId द्वारा परीक्षण स्पेक फ़ाइल के विशिष्ट निष्पादन से डिबगिंग डेटा प्राप्त करता है। |
currents-get-spec-files-performance | किसी विशिष्ट प्रोजेक्ट के लिए तारीख सीमा के भीतर स्पेक फ़ाइल प्रदर्शन मेट्रिक्स प्राप्त करता है। |
currents-get-tests-performance | किसी विशिष्ट प्रोजेक्ट के लिए तारीख सीमा के भीतर एकत्रित परीक्षण मेट्रिक्स प्राप्त करता है। |
currents-get-tests-signatures | प्रोजेक्ट, स्पेक फ़ाइल पथ और परीक्षण शीर्षक के आधार पर अद्वितीय परीक्षण हस्ताक्षर उत्पन्न करता है। |
currents-get-test-results | किसी विशिष्ट परीक्षण हस्ताक्षर के लिए ऐतिहासिक परीक्षण निष्पादन परिणाम प्राप्त करता है। |
currents-get-context | CI में विफल हुए परीक्षणों को ठीक करने के लिए उपयोग करें: यह एक रन, एक स्पेक फ़ाइल (इंस्टेंस) या एक परीक्षण के विफल परीक्षणों की त्रुटियाँ, चरण और फ़ाइलें लौटाता है — वही सामग्री जो Currents डैशबोर्ड में Fix में होती है। |
currents-get-errors-explorer | किसी प्रोजेक्ट के लिए तिथि सीमा के भीतर एकत्रित त्रुटि मेट्रिक्स प्राप्त करें। |
currents-get-test-evidence | CI रन में परीक्षणों द्वारा उत्पन्न साक्ष्य आर्टिफैक्ट (स्क्रीनशॉट, वीडियो, ट्रेस, अटैचमेंट) एकत्र करें, जिनमें हस्ताक्षरित डाउनलोड URL प्रति परीक्षण समूहीकृत होते हैं। |
currents-create-evidence-links | किसी परीक्षण प्रयास के साक्ष्य के लिए एक साझा करने योग्य लिंक बनाएं, जो उसके Playwright ट्रेस से परोसा जाता है, और उस पर URL: प्रयास ने क्या किया और क्या विफल हुआ, इसका एक मार्कडाउन सारांश, एक फिल्मस्ट्रिप, एक एनिमेटेड स्क्रीनकास्ट, DOM स्नैपशॉट, नेटवर्क अनुरोध और अटैचमेंट। |
currents-create-session | आपके द्वारा संचालित ब्राउज़र सत्र को Currents रन के रूप में रिकॉर्ड करें, ताकि उसके साक्ष्य को CI रन की तरह पढ़ा और साझा किया जा सके। |
currents-list-webhooks | किसी प्रोजेक्ट के लिए सभी वेबहुक सूचीबद्ध करें। |
currents-create-share-link | परीक्षण परिणामों के लिए एक सार्वजनिक लिंक बनाएं जिसे कोई भी बिना साइन इन किए खोल सकता है, जब तक कि वह समाप्त न हो जाए। उद्देश्य "fix" विफलता संदर्भ है, उस एजेंट के लिए जो परीक्षणों को ठीक करेगा — वही सामग्री जो currents-get-context में होती है, जिसमें फ्लैकी परीक्षण शामिल होते हैं और फ्लैकी के रूप में चिह्नित होते हैं। उद्देश्य "report" प्रत्येक परीक्षण को उसके प्रयासों और फ़ाइलों के साथ सूचीबद्ध करता है, किसी व्यक्ति के लिए। |
currents-create-webhook | किसी प्रोजेक्ट के लिए एक नया वेबहुक बनाएं। |
currents-get-webhook | ID द्वारा एक एकल वेबहुक प्राप्त करें। |
currents-update-webhook | किसी मौजूदा वेबहुक को अपडेट करें। |
currents-delete-webhook | वेबहुक हटाएं। |
कौशल (Skills)
एजेंट कौशल जो AI एजेंटों को बहु-चरणीय Currents वर्कफ़्लो सिखाते हैं।
| कौशल | विवरण |
|---|---|
browser-evidence | प्रायोगिक। |
collect-evidence | दिखाएँ कि आपके द्वारा लागू किया गया कार्य वास्तव में काम करता है, या इसे प्रदर्शित करें, उन परीक्षणों से जो Currents के माध्यम से CI में चले — एक ट्रेस लिंक जिसका डाइजेस्ट, फिल्मस्ट्रिप और एक्सेसिबिलिटी स्नैपशॉट एक टिप्पणी के अंदर पढ़े जाते हैं, साथ ही स्क्रीनशॉट, अटैचमेंट और वीडियो। |
fix-failing-tests | CI में विफल हुए परीक्षणों को ठीक करें, Currents द्वारा रिकॉर्ड किए गए परिणामों का उपयोग करके — त्रुटियाँ, चरण, ट्रेस, स्क्रीनशॉट और कंसोल आउटपुट। |
सर्वर हर कौशल को एक MCP संसाधन के रूप में प्रकाशित करता है, इसलिए एक कनेक्टेड एजेंट स्थानीय प्रति के बिना उन्हें सूचीबद्ध और पढ़ सकता है:
skill://currents/collect-evidence/SKILL.md
skill://currents/collect-evidence/references/instrumentation.md
एजेंट जो केवल डिस्क से कौशल लोड करते हैं, उन्हें अभी भी एक प्रति की आवश्यकता होती है — कौशल
निर्देशिका को एजेंट के कौशल स्थान में रखें (जैसे क्लॉड कोड के लिए .claude/skills/)।
सेटअप
API कुंजी
यहाँ दिए गए निर्देशों का पालन करके Currents API कुंजी प्राप्त करें।
Cursor के साथ उपयोग
- Cursor Settings > MCP > Enable पर जाएँ
- अपने
mcp.jsonमें निम्नलिखित जोड़ें।
{
"mcpServers": {
"currents": {
"command": "npx",
"args": ["-y", "@currents/mcp"],
"env": {
"CURRENTS_API_KEY": "your-api-key"
}
}
}
}
Claude
Claude Code में Currents MCP जोड़ने के लिए यह कमांड चलाएँ
claude mcp add --transport stdio currents --env CURRENTS_API_KEY=<KEY> -- npx -y @currents/mcp
Claude Desktop पर Currents MCP सक्षम करने के लिए निम्नलिखित जोड़ें (claude_desktop_config.json फ़ाइल संपादित करें):
{
"mcpServers": {
"currents": {
"command": "npx",
"args": ["-y", "@currents/mcp"],
"env": {
"CURRENTS_API_KEY": "your-api-key"
}
}
}
}
रिमोट (होस्टेड) MCP एंडपॉइंट
ऊपर दिए गए स्थानीय stdio ट्रांसपोर्ट के अतिरिक्त, वही सर्वर एक होस्टेड
Streamable HTTP एंडपॉइंट (जैसे https://mcp.currents.dev/mcp) के रूप में चल सकता है, जो
क्लॉड वेब/मोबाइल ऐप्स जैसे रिमोट कनेक्टर के साथ उपयोग के लिए है।
होस्टेड सर्वर अपनी ओर से कोई प्रमाणीकरण नहीं करता। प्रत्येक अनुरोध में आपकी Currents API कुंजी Bearer टोकन के रूप में होनी चाहिए, जो Currents API को पास की जाती है:
Authorization: Bearer <your-currents-api-key>
उदाहरण क्लाइंट कॉन्फ़िगरेशन (रिमोट कनेक्टर):
{
"mcpServers": {
"currents": {
"url": "https://mcp.currents.dev/mcp",
"headers": {
"Authorization": "Bearer your-api-key"
}
}
}
}
HTTP सर्वर स्वयं चलाना:
# from the mcp-server package
npm run build && PORT=3000 npm run start:http
# or via Docker (serves /mcp, exposes the configured PORT)
docker build -t currents-mcp . && docker run -p 3000:3000 currents-mcp
Node सर्वर सादा HTTP बोलता है; TLS और सार्वजनिक डोमेन कंटेनर के सामने
रिवर्स प्रॉक्सी / लोड बैलेंसर पर समाप्त होते हैं। लाइवनेस जाँच के लिए एक GET /healthz एंडपॉइंट
प्रदान किया जाता है।
⚠️ सूचना
AI टूल (जैसे MCP के माध्यम से) को Currents से जोड़कर, आप उन्हें अपनी API कुंजी, परीक्षण परिणाम और CI मेटाडेटा तक पहुँच प्रदान कर रहे हैं। आपके द्वारा उपयोग किए जाने वाले किसी भी AI एजेंट या सेवाओं की जाँच करना, और यह सुनिश्चित करना कि वे आपके डेटा को सुरक्षित रूप से संभालें, आपकी ज़िम्मेदारी है।