Currents

आधिकारिक

AI एजेंटों को Currents पर रिपोर्ट किए गए Playwright परीक्षण विफलताओं को ठीक करने में सक्षम बनाएँ।

Currents MCP के साथ आप क्या कर सकते हैं?

  • CI विफलताओं का निदान करें — किसी रन, स्पेक फ़ाइल या एकल टेस्ट में विफल टेस्ट के पीछे की त्रुटियाँ, चरण और फ़ाइलें currents-get-context से प्राप्त करें।
  • रन और परिणामों का निरीक्षण करें — प्रोजेक्ट रन की सूची बनाएँ और उन्हें फ़िल्टर करें, फिर रन का विवरण, स्पेक इंस्टेंस के परिणाम और सिग्नेचर के आधार पर ऐतिहासिक टेस्ट परिणाम प्राप्त करें।
  • अस्थिर और धीमे टेस्ट खोजें — तारीख़ की सीमा में टेस्ट और स्पेक-फ़ाइल के प्रदर्शन मेट्रिक्स तथा एकत्रित त्रुटि रुझानों की क्वेरी करें।
  • क्वारंटीन कार्रवाइयाँ प्रबंधित करें — कार्रवाइयाँ बनाएँ, सक्षम करें, अक्षम करें या हटाएँ, और उन टेस्ट तथा निष्पादनों की सूची देखें जिन पर उनका असर पड़ा।
  • टेस्ट साक्ष्य एकत्र करें — CI रन से स्क्रीनशॉट, वीडियो, ट्रेस और अटैचमेंट जुटाएँ, या साझा करने योग्य ट्रेस लिंक बनाएँ।
  • वेबहुक और Jira प्रबंधित करें — प्रोजेक्ट वेबहुक की सूची बनाएँ, उन्हें बनाएँ, अपडेट करें या हटाएँ, और रन टेस्ट से Jira इश्यू बनाएँ या लिंक करें।

दस्तावेज़

Currents MCP Server

Unit Tests

अपने AI कोडिंग एजेंट्स को अपने CI टेस्ट परिणामों की पूरी जानकारी दें। Currents MCP Server, Cursor और Claude जैसे टूल्स को सीधे आपके Currents डैशबोर्ड से जोड़ता है, ताकि एजेंट फ़्लेकी टेस्ट का निदान कर सकें, विफलताओं का सटीक पता लगा सकें और वास्तविक निष्पादन डेटा पर काम कर सकें—वह भी आपका एडिटर छोड़े बिना।

  • CI से रन, स्पेक फ़ाइलें और अलग-अलग टेस्ट परिणाम क्वेरी करें
  • अपने टेस्ट सूट में त्रुटियों के रुझान और प्रदर्शन मेट्रिक्स सामने लाएँ
  • क्वारंटीन नियम, वेबहुक और प्रोजेक्ट सेटिंग्स को प्रोग्रामेटिक रूप से प्रबंधित करें
  • एजेंट्स को अनुमान के बजाय वास्तविक टेस्ट आउटपुट का उपयोग करके खराबी ठीक करने दें

Install MCP Server

टूल

Toolविवरण
currents-list-actionsवैकल्पिक फ़िल्टर के साथ किसी प्रोजेक्ट की सभी कार्रवाइयाँ सूचीबद्ध करें।
currents-create-actionकिसी प्रोजेक्ट के लिए नई कार्रवाई बनाएँ।
currents-get-actionID के आधार पर एक कार्रवाई प्राप्त करें।
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-projectsCurrents प्लेटफ़ॉर्म पर उपलब्ध प्रोजेक्ट प्राप्त करता है।
currents-get-projectID के आधार पर एक प्रोजेक्ट प्राप्त करें।
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-typesJira प्रोजेक्ट के लिए 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-ciGitHub Actions वर्कफ़्लो रन ID और प्रयास संख्या के आधार पर रन रद्द करें।
currents-get-spec-instanceinstanceId के आधार पर एक स्पेक फ़ाइल निष्पादन का कच्चा परिणाम प्राप्त करता है: प्रत्येक टेस्ट की स्थिति और प्रयास, और आर्टिफ़ैक्ट URL।
currents-get-spec-files-performanceकिसी विशिष्ट प्रोजेक्ट के लिए तारीख की सीमा के भीतर स्पेक फ़ाइलों के प्रदर्शन मेट्रिक्स प्राप्त करता है।
currents-get-tests-performanceकिसी विशिष्ट प्रोजेक्ट के लिए तारीख की सीमा के भीतर एकत्रित टेस्ट मेट्रिक्स प्राप्त करता है।
currents-get-tests-signaturesप्रोजेक्ट, स्पेक फ़ाइल पथ और टेस्ट शीर्षक के आधार पर एक विशिष्ट टेस्ट हस्ताक्षर बनाता है।
currents-get-test-resultsकिसी विशिष्ट टेस्ट हस्ताक्षर के लिए ऐतिहासिक टेस्ट निष्पादन परिणाम प्राप्त करता है।
currents-get-contextCI में टेस्ट क्यों विफल हुए, यह जानने या उन्हें ठीक करने के लिए पहले इसे कॉल करें: किसी रन, स्पेक फ़ाइल (इंस्टेंस) या एक टेस्ट के विफल टेस्ट की त्रुटियाँ, चरण और फ़ाइलें लौटाता है — Currents डैशबोर्ड में Fix की तरह ही सामग्री।
currents-get-errors-explorerकिसी प्रोजेक्ट के लिए तारीख की सीमा के भीतर एकत्रित त्रुटि मेट्रिक्स प्राप्त करें।
currents-get-test-evidenceCI रन में टेस्ट द्वारा बनाए गए साक्ष्य आर्टिफ़ैक्ट (स्क्रीनशॉट, वीडियो, ट्रेस, अटैचमेंट) एकत्र करें; हर टेस्ट के अनुसार समूहित हस्ताक्षरित डाउनलोड URL के साथ।
currents-create-evidence-linksकिसी टेस्ट प्रयास के साक्ष्य के लिए एक साझा करने योग्य ट्रेस API लिंक बनाएँ, जिसे उसके Playwright ट्रेस से परोसा जाता है, और उसमें ये URL जोड़ें: प्रयास में क्या हुआ और क्या विफल हुआ, इसका मार्कडाउन ट्रेस सारांश ( digest URL), एक फ़िल्मस्ट्रिप, एक एनिमेटेड स्क्रीनकास्ट, DOM स्नैपशॉट, नेटवर्क अनुरोध और अटैचमेंट।
currents-create-sessionआपके द्वारा संचालित ब्राउज़र सत्र को Currents सत्र के रूप में रिकॉर्ड करें, ताकि उसके साक्ष्य पढ़े और साझा किए जा सकें।
currents-add-attachmentscurrents-create-session से किसी सत्र में अटैचमेंट जोड़ें (sessionId भेजें), या किसी CI रन में (runId भेजें): किसी स्पेक फ़ाइल, टेस्ट या रन के लॉग।
currents-list-webhooksकिसी प्रोजेक्ट के सभी वेबहुक सूचीबद्ध करें।
currents-create-share-linkटेस्ट परिणामों का एक सार्वजनिक लिंक बनाएँ, जिसे कोई भी साइन इन किए बिना, इसकी समय-सीमा समाप्त होने तक खोल सकता है। purpose "fix" विफलता का संदर्भ है, उस एजेंट के लिए जो टेस्ट ठीक करेगा — currents-get-context जैसी ही सामग्री, जिसमें अस्थिर टेस्ट शामिल हैं और उन्हें अस्थिर के रूप में चिह्नित किया गया है। purpose "report" किसी व्यक्ति के लिए हर टेस्ट को उसके प्रयासों और फ़ाइलों सहित सूचीबद्ध करता है; किसी सत्र के लिए यह सत्र पृष्ठ है: स्थिति, त्रुटि, अटैचमेंट और ट्रेस।
currents-create-webhookकिसी प्रोजेक्ट के लिए नया वेबहुक बनाएँ।
currents-get-webhookID के आधार पर एक वेबहुक प्राप्त करें।
currents-update-webhookकिसी मौजूदा वेबहुक को अपडेट करें।
currents-delete-webhookवेबहुक हटाएँ।

Skills

AI एजेंटों को Currents के कई चरणों वाले वर्कफ़्लो सिखाने वाली एजेंट स्किल्स।

SkillDescription
browser-evidenceप्रायोगिक: जब चलाने के लिए कोई टेस्ट न हो, तो खुद ब्राउज़र चलाकर साबित करें कि बदलाव काम करता है।
collect-evidenceCI में Currents के ज़रिए चले टेस्ट से दिखाएँ कि आपके द्वारा लागू किया गया काम वास्तव में काम करता है, या उसका डेमो दें — इसमें ट्रेस API लिंक शामिल है, जिसके ट्रेस सारांश, फ़िल्मस्ट्रिप और एक्सेसिबिलिटी स्नैपशॉट किसी टिप्पणी में पढ़े जा सकते हैं, साथ ही स्क्रीनशॉट, अटैचमेंट और वीडियो भी।
fix-failing-testsCI में विफल हुए टेस्ट ठीक करें, 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

  1. Cursor Settings > MCP > Enable पर जाएँ
  2. अपने 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 एजेंट या सेवा की जाँच करना और यह सुनिश्चित करना आपकी ज़िम्मेदारी है कि वे आपके डेटा को सुरक्षित रूप से संभालें।

References