Currents
आधिकारिकAI एजेंटों को Currents पर रिपोर्ट किए गए Playwright परीक्षण विफलताओं को ठीक करने में सक्षम बनाएँ।
Currents MCP के साथ आप क्या कर सकते हैं?
- CI विफलताओं का निदान करें — किसी रन, स्पेक फ़ाइल या एकल टेस्ट में विफल टेस्ट के पीछे की त्रुटियाँ, चरण और फ़ाइलें
currents-get-contextसे प्राप्त करें। - रन और परिणामों का निरीक्षण करें — प्रोजेक्ट रन की सूची बनाएँ और उन्हें फ़िल्टर करें, फिर रन का विवरण, स्पेक इंस्टेंस के परिणाम और सिग्नेचर के आधार पर ऐतिहासिक टेस्ट परिणाम प्राप्त करें।
- अस्थिर और धीमे टेस्ट खोजें — तारीख़ की सीमा में टेस्ट और स्पेक-फ़ाइल के प्रदर्शन मेट्रिक्स तथा एकत्रित त्रुटि रुझानों की क्वेरी करें।
- क्वारंटीन कार्रवाइयाँ प्रबंधित करें — कार्रवाइयाँ बनाएँ, सक्षम करें, अक्षम करें या हटाएँ, और उन टेस्ट तथा निष्पादनों की सूची देखें जिन पर उनका असर पड़ा।
- टेस्ट साक्ष्य एकत्र करें — CI रन से स्क्रीनशॉट, वीडियो, ट्रेस और अटैचमेंट जुटाएँ, या साझा करने योग्य ट्रेस लिंक बनाएँ।
- वेबहुक और Jira प्रबंधित करें — प्रोजेक्ट वेबहुक की सूची बनाएँ, उन्हें बनाएँ, अपडेट करें या हटाएँ, और रन टेस्ट से Jira इश्यू बनाएँ या लिंक करें।
दस्तावेज़
Currents MCP Server
अपने AI कोडिंग एजेंट्स को अपने CI टेस्ट परिणामों की पूरी जानकारी दें। Currents MCP Server, Cursor और Claude जैसे टूल्स को सीधे आपके Currents डैशबोर्ड से जोड़ता है, ताकि एजेंट फ़्लेकी टेस्ट का निदान कर सकें, विफलताओं का सटीक पता लगा सकें और वास्तविक निष्पादन डेटा पर काम कर सकें—वह भी आपका एडिटर छोड़े बिना।
- CI से रन, स्पेक फ़ाइलें और अलग-अलग टेस्ट परिणाम क्वेरी करें
- अपने टेस्ट सूट में त्रुटियों के रुझान और प्रदर्शन मेट्रिक्स सामने लाएँ
- क्वारंटीन नियम, वेबहुक और प्रोजेक्ट सेटिंग्स को प्रोग्रामेटिक रूप से प्रबंधित करें
- एजेंट्स को अनुमान के बजाय वास्तविक टेस्ट आउटपुट का उपयोग करके खराबी ठीक करने दें
टूल
| Tool | विवरण |
|---|---|
currents-list-actions | वैकल्पिक फ़िल्टर के साथ किसी प्रोजेक्ट की सभी कार्रवाइयाँ सूचीबद्ध करें। |
currents-create-action | किसी प्रोजेक्ट के लिए नई कार्रवाई बनाएँ। |
currents-get-action | ID के आधार पर एक कार्रवाई प्राप्त करें। |
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 | ID के आधार पर एक प्रोजेक्ट प्राप्त करें। |
currents-get-project-insights | तारीख की सीमा के भीतर किसी प्रोजेक्ट के रन और टेस्ट के समेकित मेट्रिक्स प्राप्त करें। |
currents-list-pull-requests | किसी प्रोजेक्ट के पुल रिक्वेस्ट कार्ड सूचीबद्ध करें (रन को meta.pr.id के आधार पर समूहित किया गया है)। |
currents-list-project-terms | एक प्रकार (tag, branch, 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 | रन प्राप्त करता है: इसकी स्थिति, कमिट, ब्रांच, ग्रुप और स्पेक फ़ाइलें, प्रत्येक का instanceId, और स्तर, प्रकार तथा स्रोत (attachmentCounts) के अनुसार रन में फ़ाइलों की संख्या। |
currents-find-run | क्वेरी पैरामीटर के आधार पर रन खोजें। |
currents-cancel-run | प्रगति में चल रहे रन को रद्द करें। |
currents-reset-run | रन में विफल स्पेक फ़ाइलों को रीसेट करें ताकि उन्हें फिर से निष्पादित किया जा सके। |
currents-delete-run | एक रन और उससे जुड़ा सारा डेटा हटाएँ। |
currents-cancel-run-github-ci | GitHub Actions वर्कफ़्लो रन ID और प्रयास संख्या के आधार पर रन रद्द करें। |
currents-get-spec-instance | instanceId के आधार पर एक स्पेक फ़ाइल निष्पादन का कच्चा परिणाम प्राप्त करता है: प्रत्येक टेस्ट की स्थिति और प्रयास, और आर्टिफ़ैक्ट URL। |
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 | किसी टेस्ट प्रयास के साक्ष्य के लिए एक साझा करने योग्य ट्रेस API लिंक बनाएँ, जिसे उसके Playwright ट्रेस से परोसा जाता है, और उसमें ये URL जोड़ें: प्रयास में क्या हुआ और क्या विफल हुआ, इसका मार्कडाउन ट्रेस सारांश ( digest URL), एक फ़िल्मस्ट्रिप, एक एनिमेटेड स्क्रीनकास्ट, DOM स्नैपशॉट, नेटवर्क अनुरोध और अटैचमेंट। |
currents-create-session | आपके द्वारा संचालित ब्राउज़र सत्र को Currents सत्र के रूप में रिकॉर्ड करें, ताकि उसके साक्ष्य पढ़े और साझा किए जा सकें। |
currents-add-attachments | currents-create-session से किसी सत्र में अटैचमेंट जोड़ें (sessionId भेजें), या किसी CI रन में (runId भेजें): किसी स्पेक फ़ाइल, टेस्ट या रन के लॉग। |
currents-list-webhooks | किसी प्रोजेक्ट के सभी वेबहुक सूचीबद्ध करें। |
currents-create-share-link | टेस्ट परिणामों का एक सार्वजनिक लिंक बनाएँ, जिसे कोई भी साइन इन किए बिना, इसकी समय-सीमा समाप्त होने तक खोल सकता है। purpose "fix" विफलता का संदर्भ है, उस एजेंट के लिए जो टेस्ट ठीक करेगा — currents-get-context जैसी ही सामग्री, जिसमें अस्थिर टेस्ट शामिल हैं और उन्हें अस्थिर के रूप में चिह्नित किया गया है। purpose "report" किसी व्यक्ति के लिए हर टेस्ट को उसके प्रयासों और फ़ाइलों सहित सूचीबद्ध करता है; किसी सत्र के लिए यह सत्र पृष्ठ है: स्थिति, त्रुटि, अटैचमेंट और ट्रेस। |
currents-create-webhook | किसी प्रोजेक्ट के लिए नया वेबहुक बनाएँ। |
currents-get-webhook | ID के आधार पर एक वेबहुक प्राप्त करें। |
currents-update-webhook | किसी मौजूदा वेबहुक को अपडेट करें। |
currents-delete-webhook | वेबहुक हटाएँ। |
Skills
AI एजेंटों को Currents के कई चरणों वाले वर्कफ़्लो सिखाने वाली एजेंट स्किल्स।
| Skill | Description |
|---|---|
browser-evidence | प्रायोगिक: जब चलाने के लिए कोई टेस्ट न हो, तो खुद ब्राउज़र चलाकर साबित करें कि बदलाव काम करता है। |
collect-evidence | CI में Currents के ज़रिए चले टेस्ट से दिखाएँ कि आपके द्वारा लागू किया गया काम वास्तव में काम करता है, या उसका डेमो दें — इसमें ट्रेस API लिंक शामिल है, जिसके ट्रेस सारांश, फ़िल्मस्ट्रिप और एक्सेसिबिलिटी स्नैपशॉट किसी टिप्पणी में पढ़े जा सकते हैं, साथ ही स्क्रीनशॉट, अटैचमेंट और वीडियो भी। |
fix-failing-tests | CI में विफल हुए टेस्ट ठीक करें, Currents द्वारा रिकॉर्ड किए गए नतीजों — त्रुटियों, चरणों, ट्रेस, स्क्रीनशॉट और कंसोल आउटपुट — का उपयोग करके। |
सर्वर हर स्किल को MCP संसाधन के रूप में प्रकाशित करता है, इसलिए कनेक्ट किया गया एजेंट स्थानीय कॉपी के बिना उन्हें सूचीबद्ध और पढ़ सकता है:
skill://currents/collect-evidence/SKILL.md
skill://currents/collect-evidence/references/instrumentation.md
जो एजेंट स्किल्स केवल डिस्क से लोड करते हैं, उन्हें फिर भी एक कॉपी चाहिए — स्किल
डायरेक्टरी को एजेंट के स्किल्स स्थान पर रखें (उदाहरण के लिए, Claude
Code के लिए .claude/skills/)।
Setup
API Key
यहाँ दिए गए निर्देशों का पालन करके Currents API key प्राप्त करें।
Usage with 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"
}
}
}
}
VS Code and GitHub Copilot
VS Code में इंस्टॉल करें से होस्ट किया गया सर्वर जुड़ जाता है। पहली बार कनेक्ट होने पर VS Code Currents साइन-इन पेज खोलता है; दर्ज करने के लिए कोई API key नहीं होती।
प्लगइन इंस्टॉल करने के लिए, जो सर्वर के साथ-साथ skills भी जोड़ता है:
-
VS Code:
vscode://chat-plugin/install?source=currents-dev/currents-mcpखोलें -
Copilot CLI:
copilot plugin marketplace add currents-dev/currents-mcp copilot plugin install currents@currents
Copilot CLI में केवल सर्वर जोड़ने के लिए:
copilot mcp add --transport http currents https://mcp.currents.dev/mcp
Remote (hosted) MCP endpoint
ऊपर दिए गए स्थानीय stdio ट्रांसपोर्ट के अलावा, यही सर्वर होस्ट किए गए
Streamable HTTP endpoint (उदाहरण के लिए, https://mcp.currents.dev/mcp) के रूप में भी चल सकता है, जिसका उपयोग Claude वेब/मोबाइल ऐप्स जैसे रिमोट
कनेक्टरों के साथ किया जा सकता है।
होस्ट किया गया सर्वर अपना कोई प्रमाणीकरण नहीं करता। हर अनुरोध में Bearer token के रूप में आपकी Currents API key होनी चाहिए, जिसे 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 endpoint
उपलब्ध कराया गया है।
⚠️ सूचना
AI टूल (उदाहरण के लिए, MCP के ज़रिए) को Currents से कनेक्ट करके, आप उन्हें अपनी API key, टेस्ट नतीजों और CI मेटाडेटा तक पहुँच दे रहे हैं। आपके द्वारा उपयोग किए जाने वाले किसी भी AI एजेंट या सेवा की जाँच करना और यह सुनिश्चित करना आपकी ज़िम्मेदारी है कि वे आपके डेटा को सुरक्षित रूप से संभालें।