Currents

ทางการ

เปิดให้ AI Agents สามารถแก้ไขข้อผิดพลาดของ Playwright test ที่รายงานไปยัง Currents ได้

คุณทำอะไรได้บ้างด้วย Currents MCP?

  • วิเคราะห์ปัญหา CI — ดึงข้อผิดพลาด ขั้นตอน และไฟล์ที่เกี่ยวข้องกับการทดสอบที่ล้มเหลวในรัน ไฟล์สเปก หรือการทดสอบรายการเดียวด้วย currents-get-context
  • ตรวจสอบรันและผลลัพธ์ — แสดงรายการและกรองรันของโปรเจกต์ จากนั้นดึงรายละเอียดรัน ผลลัพธ์ของอินสแตนซ์สเปก และผลการทดสอบย้อนหลังตามลายเซ็น
  • ค้นหาการทดสอบที่ไม่เสถียรและทำงานช้า — ค้นหาเมตริกประสิทธิภาพของการทดสอบและไฟล์สเปก รวมถึงแนวโน้มข้อผิดพลาดแบบรวมในช่วงวันที่ที่กำหนด
  • จัดการการกักกัน — สร้าง เปิดใช้ ปิดใช้ หรือลบการดำเนินการ และแสดงรายการการทดสอบกับการรันที่ได้รับผลกระทบ
  • รวบรวมหลักฐานการทดสอบ — รวบรวมภาพหน้าจอ วิดีโอ เทรซ และไฟล์แนบจากรัน CI หรือสร้างลิงก์เทรซที่แชร์ได้
  • จัดการเว็บฮุกและ Jira — แสดงรายการ สร้าง อัปเดต หรือลบเว็บฮุกของโปรเจกต์ และสร้างหรือเชื่อมโยงปัญหา Jira จากการทดสอบในรัน

เอกสาร

Currents MCP Server

Unit Tests

มอบการมองเห็นผลการทดสอบ CI อย่างครบถ้วนให้กับเอเจนต์เขียนโค้ด AI ของคุณ Currents MCP Server เชื่อมต่อเครื่องมืออย่าง Cursor และ Claude เข้ากับแดชบอร์ด Currents ของคุณโดยตรง เพื่อให้เอเจนต์วิเคราะห์การทดสอบที่ไม่เสถียร ระบุจุดที่ล้มเหลว และดำเนินการกับข้อมูลการรันทดสอบจริงได้ โดยไม่ต้องออกจากเอดิเตอร์ของคุณ

  • ค้นหาการรัน ไฟล์ spec และผลการทดสอบแต่ละรายการจาก CI
  • แสดงแนวโน้มข้อผิดพลาดและเมตริกประสิทธิภาพทั่วทั้งชุดทดสอบของคุณ
  • จัดการกฎการกักกัน เว็บฮุก และการตั้งค่าโปรเจกต์ผ่านโปรแกรม
  • ให้เอเจนต์แก้ไขสิ่งที่เสียโดยใช้ผลการทดสอบจริง ไม่ใช่การคาดเดา

Install MCP Server

เครื่องมือ

ToolDescription
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ใช้การทดสอบเป็นเกณฑ์: แสดงรายการการดำเนินการทดสอบของการทดสอบหนึ่งรายการที่ได้รับผลจากการดำเนินการ ภายในช่วงวันที่ที่กำหนด พร้อม run, branch และ commit ของแต่ละรายการ
currents-get-action-executionsใช้การดำเนินการเป็นเกณฑ์: แสดงรายการการดำเนินการทดสอบที่กฎหนึ่งข้อมีผลกับการทดสอบทั้งหมดที่กฎนั้นส่งผล ภายในช่วงวันที่ที่กำหนด
currents-get-projectsดึงข้อมูลโปรเจกต์ที่มีอยู่บนแพลตฟอร์ม Currents
currents-get-projectดึงข้อมูลโปรเจกต์รายการเดียวตาม ID
currents-get-project-insightsดึงข้อมูลเมตริก run และการทดสอบแบบรวมของโปรเจกต์ภายในช่วงวันที่ที่กำหนด
currents-list-pull-requestsแสดงรายการการ์ด pull request ของโปรเจกต์ (จัดกลุ่ม run ตาม meta.pr.id)
currents-list-project-termsแสดงรายการคำศัพท์ของโปรเจกต์แบบแบ่งหน้าด้วยเคอร์เซอร์สำหรับประเภทหนึ่ง (tag, branch, authorName ฯลฯ)
currents-create-jira-issueสร้าง Jira issue จากการทดสอบใน run โดยใช้การผสานการทำงาน Jira ขององค์กร
currents-link-jira-issueเชื่อมโยง Jira issue ที่มีอยู่กับการทดสอบใน run โดยใช้การผสานการทำงาน Jira ขององค์กร
currents-list-jira-projectsแสดงรายการโปรเจกต์ Jira ที่พร้อมใช้งานสำหรับการผสานการทำงานขององค์กร
currents-list-jira-issue-typesแสดงรายการประเภท Jira issue และฟิลด์ที่กำหนดเองสำหรับโปรเจกต์ Jira
currents-get-runsดึงรายการ run ของโปรเจกต์ที่ระบุ พร้อมตัวกรองเพิ่มเติมได้
currents-get-run-detailsดึงข้อมูล run ได้แก่ สถานะ commit branch กลุ่ม และไฟล์ spec โดยแต่ละรายการมี instanceId รวมถึงจำนวนไฟล์ใน run แยกตามระดับ ประเภท และแหล่งที่มา (attachmentCounts)
currents-find-runค้นหา run ด้วยพารามิเตอร์การค้นหา
currents-cancel-runยกเลิก run ที่กำลังดำเนินการ
currents-reset-runรีเซ็ตไฟล์ spec ที่ล้มเหลวใน run เพื่อให้เรียกใช้ซ้ำได้
currents-delete-runลบการรันและข้อมูลทั้งหมดที่เกี่ยวข้อง
currents-cancel-run-github-ciยกเลิกการรันโดยใช้ ID การรันเวิร์กโฟลว์ GitHub Actions และหมายเลขครั้งที่รัน
currents-get-spec-instanceดึงผลลัพธ์ดิบของการเรียกใช้ไฟล์ spec หนึ่งไฟล์ตาม instanceId: สถานะและจำนวนครั้งที่ลองของการทดสอบแต่ละรายการ รวมถึง URL ของอาร์ติแฟกต์
currents-get-spec-files-performanceดึงเมตริกประสิทธิภาพของไฟล์ spec สำหรับโปรเจกต์ที่ระบุภายในช่วงวันที่กำหนด
currents-get-tests-performanceดึงเมตริกการทดสอบแบบรวมสำหรับโปรเจกต์ที่ระบุภายในช่วงวันที่กำหนด
currents-get-tests-signaturesสร้างลายเซ็นการทดสอบที่ไม่ซ้ำกันโดยอิงจากโปรเจกต์ พาธไฟล์ spec และชื่อการทดสอบ
currents-get-test-resultsดึงผลการเรียกใช้การทดสอบย้อนหลังสำหรับลายเซ็นการทดสอบที่ระบุ
currents-get-contextเรียกใช้สิ่งนี้ก่อนเพื่อดูสาเหตุที่การทดสอบล้มเหลวใน CI หรือเพื่อแก้ไข: ส่งคืนข้อผิดพลาด ขั้นตอน และไฟล์ของการทดสอบที่ล้มเหลวในการรัน ไฟล์ spec (instance) หรือการทดสอบหนึ่งรายการ ซึ่งเป็นเนื้อหาเดียวกับ Fix ในแดชบอร์ด Currents
currents-get-errors-explorerรับเมตริกข้อผิดพลาดแบบรวมสำหรับโปรเจกต์ภายในช่วงวันที่กำหนด
currents-get-test-evidenceรวบรวมอาร์ติแฟกต์หลักฐาน (ภาพหน้าจอ วิดีโอ trace ไฟล์แนบ) ที่การทดสอบสร้างขึ้นในการรัน CI พร้อม URL ดาวน์โหลดที่ลงนามแล้วซึ่งจัดกลุ่มตามการทดสอบ
currents-create-evidence-linksสร้างลิงก์ API ของ trace ที่แชร์ได้ไปยังหลักฐานของการทดสอบหนึ่งครั้ง โดยให้บริการจาก Playwright trace และ URL ที่เกี่ยวข้อง ได้แก่ สรุป trace ในรูปแบบ markdown (URL digest) ที่อธิบายสิ่งที่เกิดขึ้นและสิ่งที่ล้มเหลวในครั้งนั้น ฟิล์มสตริป ภาพหน้าจอเคลื่อนไหว สแนปช็อต DOM คำขอเครือข่าย และไฟล์แนบ
currents-create-sessionบันทึกเซสชันเบราว์เซอร์ที่คุณควบคุมเป็นเซสชัน Currents เพื่อให้สามารถอ่านและแชร์หลักฐานได้
currents-add-attachmentsเพิ่มไฟล์แนบไปยังเซสชันจาก currents-create-session (ส่ง sessionId) หรือไปยังการรัน CI (ส่ง runId): บันทึกสำหรับไฟล์ spec การทดสอบ หรือการรันเอง
currents-list-webhooksแสดงรายการเว็บฮุกทั้งหมดของโปรเจกต์
currents-create-share-linkสร้างลิงก์สาธารณะไปยังผลการทดสอบที่ทุกคนเปิดได้โดยไม่ต้องลงชื่อเข้าใช้จนกว่าลิงก์จะหมดอายุ purpose "fix" คือบริบทของความล้มเหลวสำหรับเอเจนต์ที่จะใช้แก้ไขการทดสอบ ซึ่งเป็นเนื้อหาเดียวกับ currents-get-context โดยรวมการทดสอบที่ไม่เสถียรและระบุว่าไม่เสถียร ส่วน purpose "report" จะแสดงการทดสอบทุกรายการพร้อมจำนวนครั้งที่ลองและไฟล์สำหรับบุคคลทั่วไป สำหรับเซสชันจะแสดงหน้าเซสชัน ได้แก่ สถานะ ข้อผิดพลาด ไฟล์แนบ และ trace
currents-create-webhookสร้างเว็บฮุกใหม่สำหรับโปรเจกต์
currents-get-webhookรับข้อมูลเว็บฮุกหนึ่งรายการตาม ID
currents-update-webhookอัปเดตเว็บฮุกที่มีอยู่
currents-delete-webhookลบเว็บฮุก

Skills

ทักษะของเอเจนต์ที่สอนเวิร์กโฟลว์ Currents แบบหลายขั้นตอนให้แก่เอเจนต์ AI

ทักษะคำอธิบาย
browser-evidenceทดลอง: พิสูจน์ว่าการเปลี่ยนแปลงใช้งานได้ในเบราว์เซอร์ที่คุณควบคุมเอง เมื่อไม่มีการทดสอบให้เรียกใช้
collect-evidenceแสดงให้เห็นว่างานที่คุณนำไปใช้ใช้งานได้จริง หรือสาธิตงานนั้น โดยอ้างอิงจากการทดสอบที่ทำงานใน CI ผ่าน Currents — ลิงก์ trace API ที่มีสรุป trace, filmstrip และภาพสแนปช็อตการช่วยการเข้าถึงให้อ่านได้ในคอมเมนต์ พร้อมภาพหน้าจอ ไฟล์แนบ และวิดีโอ
fix-failing-testsแก้ไขการทดสอบที่ล้มเหลวใน CI โดยใช้ผลลัพธ์ที่ Currents บันทึกไว้ ได้แก่ ข้อผิดพลาด ขั้นตอน trace ภาพหน้าจอ และเอาต์พุตคอนโซล

เซิร์ฟเวอร์เผยแพร่ทักษะทุกทักษะเป็นทรัพยากร MCP ดังนั้นเอเจนต์ที่เชื่อมต่อจึงสามารถ แสดงรายการและอ่านทักษะเหล่านั้นได้โดยไม่ต้องมีสำเนาในเครื่อง:

skill://currents/collect-evidence/SKILL.md
skill://currents/collect-evidence/references/instrumentation.md

เอเจนต์ที่โหลดทักษะจากดิสก์เท่านั้นยังต้องมีสำเนา — ให้วางไดเรกทอรีทักษะ ไว้ในตำแหน่งจัดเก็บทักษะของเอเจนต์ (เช่น .claude/skills/ สำหรับ Claude Code)

การตั้งค่า

API Key

รับ API key ของ Currents โดยทำตามคำแนะนำที่นี่

การใช้งานกับ 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

เรียกใช้คำสั่งนี้เพื่อเพิ่ม Currents MCP ลงใน Claude Code

claude mcp add --transport stdio currents --env CURRENTS_API_KEY=<KEY> -- npx -y @currents/mcp

เพิ่มรายการต่อไปนี้เพื่อเปิดใช้ Currents MCP บน Claude Desktop (แก้ไขไฟล์ claude_desktop_config.json):

{
  "mcpServers": {
    "currents": {
      "command": "npx",
      "args": ["-y", "@currents/mcp"],
      "env": {
        "CURRENTS_API_KEY": "your-api-key"
      }
    }
  }
}

VS Code และ GitHub Copilot

ติดตั้งใน VS Code จะเพิ่มเซิร์ฟเวอร์ที่โฮสต์ไว้ เมื่อเชื่อมต่อครั้งแรก VS Code จะเปิดหน้าเข้าสู่ระบบ Currents โดยไม่ต้องป้อน API key

หากต้องการติดตั้งปลั๊กอิน ซึ่งเพิ่มทั้งทักษะและเซิร์ฟเวอร์:

  • 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

MCP endpoint ระยะไกล (โฮสต์)

นอกเหนือจากการขนส่งแบบ stdio ในเครื่องที่กล่าวถึงข้างต้นแล้ว เซิร์ฟเวอร์เดียวกันยังสามารถทำงานเป็น Streamable HTTP endpoint ที่โฮสต์ไว้ (เช่น https://mcp.currents.dev/mcp) เพื่อใช้งานกับ ตัวเชื่อมต่อระยะไกล เช่น แอป Claude บนเว็บ/มือถือ

เซิร์ฟเวอร์ที่โฮสต์ไว้ไม่มีการตรวจสอบสิทธิ์ของตัวเอง ทุกคำขอต้องแนบ API key ของ Currents เป็น Bearer token ซึ่งจะส่งต่อไปยัง 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 และโดเมนสาธารณะจะสิ้นสุดที่ reverse proxy / load balancer ซึ่งอยู่หน้า container มี endpoint GET /healthz สำหรับตรวจสอบสถานะการทำงาน

⚠️ ประกาศ

การเชื่อมต่อเครื่องมือ AI (เช่น ผ่าน MCP) กับ Currents เป็นการให้สิทธิ์เข้าถึง API key ผลการทดสอบ และข้อมูลเมตาของ CI แก่เครื่องมือเหล่านั้น คุณมีหน้าที่ตรวจสอบเอเจนต์หรือบริการ AI ที่คุณใช้ และตรวจสอบให้แน่ใจว่าเครื่องมือเหล่านั้นจัดการข้อมูลของคุณอย่างปลอดภัย

ข้อมูลอ้างอิง