Currents
ทางการเปิดให้ AI Agents สามารถแก้ไขข้อผิดพลาดของ Playwright test ที่รายงานไปยัง Currents ได้
คุณทำอะไรได้บ้างด้วย Currents MCP?
- สอบถามการรันและผลการทดสอบ — ขอข้อมูลการรัน CI ล่าสุดหรือผลลัพธ์ย้อนหลังผ่าน
currents-get-runsและcurrents-get-test-results - วินิจฉัยข้อผิดพลาดพร้อมบริบท — รับบริบทของข้อผิดพลาดสำหรับการดีบักด้วย AI ในระดับการรัน อินสแตนซ์ หรือการทดสอบ โดยใช้
currents-get-context - รวบรวมหลักฐานการทดสอบ — ดึงภาพหน้าจอ วิดีโอ เทรซ และไฟล์แนบจากการรัน CI ด้วย
currents-get-test-evidence - จัดการการกักกันและการดำเนินการ — แสดงรายการ สร้าง อัปเดต หรือปิดใช้งานการดำเนินการ เช่น กฎการกักกัน ผ่าน
currents-list-actionsและcurrents-create-action - จัดการเว็บฮุค — แสดงรายการ สร้าง อัปเดต หรือลบเว็บฮุคของโปรเจกต์ด้วย
currents-list-webhooksและcurrents-create-webhook
เอกสาร
เซิร์ฟเวอร์ MCP ของ Currents
มอบความสามารถในการมองเห็นผลการทดสอบ CI ของคุณอย่างเต็มรูปแบบให้กับเอเจนต์เขียนโค้ด AI ของคุณ เซิร์ฟเวอร์ MCP ของ Currents เชื่อมต่อเครื่องมืออย่าง Cursor และ Claude เข้ากับแดชบอร์ด Currents ของคุณโดยตรง ทำให้เอเจนต์สามารถวินิจฉัยการทดสอบที่ไม่เสถียร ระบุสาเหตุของความล้มเหลว และดำเนินการกับข้อมูลการทำงานจริงได้ -- โดยไม่ต้องออกจากโปรแกรมแก้ไขของคุณ
- ค้นหาชุดการทำงาน ไฟล์ spec และผลการทดสอบรายบุคคลจาก CI
- แสดงแนวโน้มข้อผิดพลาดและตัวชี้วัดประสิทธิภาพทั่วทั้งชุดการทดสอบของคุณ
- จัดการกฎการกักกัน เว็บฮุค และการตั้งค่าโปรเจกต์โดยทางโปรแกรม
- ให้เอเจนต์แก้ไขสิ่งที่เสียหายโดยใช้ผลลัพธ์การทดสอบจริง ไม่ใช่การคาดเดา
เครื่องมือ
| เครื่องมือ | คำอธิบาย |
|---|---|
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-affected-executions | แสดงรายการการทำงานของการทดสอบที่มีการใช้การดำเนินการ/กฎเฉพาะ ภายในช่วงวันที่ |
currents-get-projects | ดึงข้อมูลโปรเจกต์ที่พร้อมใช้งานในแพลตฟอร์ม Currents |
currents-get-project | รับโปรเจกต์เดียวตาม ID |
currents-get-project-insights | รับตัวชี้วัดการทำงานและการทดสอบแบบรวมสำหรับโปรเจกต์ภายในช่วงวันที่ |
currents-list-pull-requests | แสดงรายการการ์ด pull-request สำหรับโปรเจกต์ (การทำงานที่จัดกลุ่มตาม meta.pr.id) |
currents-list-project-terms | แสดงรายการคำศัพท์โปรเจกต์แบบแบ่งหน้าด้วยเคอร์เซอร์สำหรับหนึ่งประเภท (แท็ก สาขา ชื่อผู้เขียน ฯลฯ) |
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 | รีเซ็ตไฟล์ spec ที่ล้มเหลวในการทำงานเพื่ออนุญาตให้ดำเนินการใหม่ |
currents-delete-run | ลบการทำงานและข้อมูลที่เกี่ยวข้องทั้งหมด |
currents-cancel-run-github-ci | ยกเลิกการทำงานตาม ID การทำงานของ GitHub Actions และหมายเลขครั้งที่พยายาม |
currents-get-spec-instance | ดึงข้อมูลการดีบักจากการทำงานเฉพาะของไฟล์ spec การทดสอบตาม instanceId |
currents-get-spec-files-performance | ดึงข้อมูลตัวชี้วัดประสิทธิภาพของไฟล์ spec สำหรับโปรเจกต์เฉพาะภายในช่วงวันที่ |
currents-get-tests-performance | ดึงข้อมูลตัวชี้วัดการทดสอบแบบรวมสำหรับโปรเจกต์เฉพาะภายในช่วงวันที่ |
currents-get-tests-signatures | สร้างลายเซ็นการทดสอบที่ไม่ซ้ำกันตามโปรเจกต์ เส้นทางไฟล์ spec และชื่อการทดสอบ |
currents-get-test-results | ดึงข้อมูลผลการทำงานการทดสอบในอดีตสำหรับลายเซ็นการทดสอบเฉพาะ |
currents-get-context | รับบริบทความล้มเหลวของการทดสอบสำหรับการดีบัก AI ในระดับการทำงาน อินสแตนซ์ หรือการทดสอบ |
currents-get-errors-explorer | รับตัวชี้วัดข้อผิดพลาดแบบรวมสำหรับโปรเจกต์ภายในช่วงวันที่ |
currents-get-test-evidence | รวบรวมสิ่งประดิษฐ์หลักฐาน (ภาพหน้าจอ วิดีโอ ร่องรอย ไฟล์แนบ) ที่สร้างโดยการทดสอบในการทำงาน CI พร้อม URL ดาวน์โหลดที่ลงนามซึ่งจัดกลุ่มตามการทดสอบ |
currents-list-webhooks | แสดงรายการเว็บฮุคทั้งหมดสำหรับโปรเจกต์ |
currents-create-webhook | สร้างเว็บฮุคใหม่สำหรับโปรเจกต์ |
currents-get-webhook | รับเว็บฮุคเดียวตาม ID |
currents-update-webhook | อัปเดตเว็บฮุคที่มีอยู่ |
currents-delete-webhook | ลบเว็บฮุค |
ทักษะ
ทักษะของเอเจนต์ที่สอนเอเจนต์ AI เกี่ยวกับขั้นตอนการทำงานหลายขั้นตอนของ Currents
| ทักษะ | คำอธิบาย |
|---|---|
collect-evidence | แสดงว่างานที่ดำเนินการทำงานได้ผล หรือสาธิต โดยใช้สิ่งประดิษฐ์การทดสอบ CI -- ภาพหน้าจอก่อน/หลัง ไฟล์แนบข้อความ วิดีโอ ร่องรอย |
เซิร์ฟเวอร์เผยแพร่ทุกทักษะเป็นทรัพยากร MCP ดังนั้นเอเจนต์ที่เชื่อมต่อสามารถ แสดงรายการและอ่านได้โดยไม่ต้องมีสำเนาในเครื่อง:
skill://currents/collect-evidence/SKILL.md
skill://currents/collect-evidence/references/instrumentation.md
เอเจนต์ที่โหลดทักษะจากดิสก์เท่านั้นยังคงต้องมีสำเนา -- วางไดเรกทอรีทักษะ
ในตำแหน่งทักษะของเอเจนต์ (เช่น .claude/skills/ สำหรับ Claude
Code)
การตั้งค่า
คีย์ API
รับคีย์ API ของ 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"
}
}
}
}
ปลายทาง MCP ระยะไกล (โฮสต์)
นอกเหนือจากการขนส่ง stdio ในเครื่องด้านบน เซิร์ฟเวอร์เดียวกันสามารถทำงานเป็น
ปลายทาง Streamable HTTP ที่โฮสต์ (เช่น https://mcp.currents.dev/mcp) สำหรับใช้กับ
ตัวเชื่อมต่อระยะไกล เช่น แอป Claude บนเว็บ/มือถือ
เซิร์ฟเวอร์ที่โฮสต์ ไม่มีการตรวจสอบสิทธิ์ของตัวเอง แต่ละคำขอต้องมี คีย์ API ของ Currents ของคุณเป็นโทเค็น Bearer ซึ่งจะถูกส่งต่อไปยัง API ของ Currents:
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 ที่คุณใช้ และตรวจสอบให้แน่ใจว่าพวกเขาจัดการข้อมูลของคุณอย่างปลอดภัย