Currents

ทางการ

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

GitHub
19
ลองใช้ MCP นี้ผู้สนับสนุน

คุณทำอะไรได้บ้างด้วย 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

Unit Tests

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

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

Install MCP Server

เครื่องมือ

เครื่องมือคำอธิบาย
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

  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"
      }
    }
  }
}

ปลายทาง 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 ที่คุณใช้ และตรวจสอบให้แน่ใจว่าพวกเขาจัดการข้อมูลของคุณอย่างปลอดภัย

เอกสารอ้างอิง