Currents
ทางการเปิดให้ AI Agents สามารถแก้ไขข้อผิดพลาดของ Playwright test ที่รายงานไปยัง Currents ได้
คุณทำอะไรได้บ้างด้วย Currents MCP?
- วิเคราะห์ปัญหา CI — ดึงข้อผิดพลาด ขั้นตอน และไฟล์ที่เกี่ยวข้องกับการทดสอบที่ล้มเหลวในรัน ไฟล์สเปก หรือการทดสอบรายการเดียวด้วย
currents-get-context - ตรวจสอบรันและผลลัพธ์ — แสดงรายการและกรองรันของโปรเจกต์ จากนั้นดึงรายละเอียดรัน ผลลัพธ์ของอินสแตนซ์สเปก และผลการทดสอบย้อนหลังตามลายเซ็น
- ค้นหาการทดสอบที่ไม่เสถียรและทำงานช้า — ค้นหาเมตริกประสิทธิภาพของการทดสอบและไฟล์สเปก รวมถึงแนวโน้มข้อผิดพลาดแบบรวมในช่วงวันที่ที่กำหนด
- จัดการการกักกัน — สร้าง เปิดใช้ ปิดใช้ หรือลบการดำเนินการ และแสดงรายการการทดสอบกับการรันที่ได้รับผลกระทบ
- รวบรวมหลักฐานการทดสอบ — รวบรวมภาพหน้าจอ วิดีโอ เทรซ และไฟล์แนบจากรัน CI หรือสร้างลิงก์เทรซที่แชร์ได้
- จัดการเว็บฮุกและ Jira — แสดงรายการ สร้าง อัปเดต หรือลบเว็บฮุกของโปรเจกต์ และสร้างหรือเชื่อมโยงปัญหา Jira จากการทดสอบในรัน
เอกสาร
Currents MCP Server
มอบการมองเห็นผลการทดสอบ CI อย่างครบถ้วนให้กับเอเจนต์เขียนโค้ด AI ของคุณ Currents MCP Server เชื่อมต่อเครื่องมืออย่าง Cursor และ Claude เข้ากับแดชบอร์ด Currents ของคุณโดยตรง เพื่อให้เอเจนต์วิเคราะห์การทดสอบที่ไม่เสถียร ระบุจุดที่ล้มเหลว และดำเนินการกับข้อมูลการรันทดสอบจริงได้ โดยไม่ต้องออกจากเอดิเตอร์ของคุณ
- ค้นหาการรัน ไฟล์ spec และผลการทดสอบแต่ละรายการจาก CI
- แสดงแนวโน้มข้อผิดพลาดและเมตริกประสิทธิภาพทั่วทั้งชุดทดสอบของคุณ
- จัดการกฎการกักกัน เว็บฮุก และการตั้งค่าโปรเจกต์ผ่านโปรแกรม
- ให้เอเจนต์แก้ไขสิ่งที่เสียโดยใช้ผลการทดสอบจริง ไม่ใช่การคาดเดา
เครื่องมือ
| Tool | Description |
|---|---|
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
- ไปที่ Cursor Settings > MCP > Enable
- เพิ่มรายการต่อไปนี้ลงใน
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 ที่คุณใช้ และตรวจสอบให้แน่ใจว่าเครื่องมือเหล่านั้นจัดการข้อมูลของคุณอย่างปลอดภัย