เซิร์ฟเวอร์ MCP

Perch เชื่อมต่อกับแหล่งข้อมูลภายนอกผ่าน Model Context Protocol โดยมีเซิร์ฟเวอร์สำหรับค้นคว้าข้อมูลกฎหมายและควบคุมเบราว์เซอร์อัตโนมัติมาให้พร้อมใช้ และคุณเพิ่มเซิร์ฟเวอร์ของคุณเองได้

Perch เชื่อมต่อกับระบบภายนอกได้ผ่าน Model Context Protocol หรือ MCP ซึ่งทำให้ Perch เข้าถึงข้อมูลและเครื่องมือที่ไม่ได้เป็นไฟล์บนดิสก์ของคุณ เช่น ฐานข้อมูลกฎหมาย การควบคุมเบราว์เซอร์อัตโนมัติ API ภายในองค์กร หรืออะไรก็ตามที่รองรับ MCP เครื่องมือจากเซิร์ฟเวอร์ที่เชื่อมต่อจะแสดงอยู่ข้างเครื่องมือในตัวของ Perch และโมเดลเรียกใช้ได้โดยตรง

สรุปสั้นๆ

เซิร์ฟเวอร์ MCP ขยายสิ่งที่ Perch เข้าถึงได้ มีสองเซิร์ฟเวอร์ที่มาเป็นค่าเริ่มต้น คือ CourtListener สำหรับค้นคว้าข้อมูลกฎหมาย และ Playwright สำหรับควบคุมเบราว์เซอร์อัตโนมัติ คุณเพิ่มเซิร์ฟเวอร์อื่นได้ในไฟล์ config

สิ่งที่มีมาให้เป็นค่าเริ่มต้น

เมื่อคุณเปิด Perch Terminal Desktop ครั้งแรก แอปจะสร้างไฟล์ config ที่ ~/.perch/mcp.json โดยตั้งค่าเซิร์ฟเวอร์ไว้แล้วสองตัว

CourtListener เซิร์ฟเวอร์ค้นคว้าข้อมูลกฎหมายที่ค้นหาแนวคำพิพากษา ค้นหาการอ้างอิง ดึงข้อความคำวินิจฉัย หาคดีที่เกี่ยวข้อง และดึงรายการในสารบบคดีได้ เชื่อมต่อกับฐานข้อมูล CourtListener ซึ่งครอบคลุมศาลรัฐบาลกลางและศาลมลรัฐ มี API token มาให้ในตัว จึงใช้ได้ตั้งแต่เปิดครั้งแรกโดยไม่ต้องตั้งค่า
Playwright เซิร์ฟเวอร์ควบคุมเบราว์เซอร์อัตโนมัติที่ปักหมุดไว้กับเวอร์ชันที่ทดสอบแล้วของ @playwright/mcp นี่คือสิ่งที่ขับเคลื่อนการส่งมอบผ่านเบราว์เซอร์ของ Perch ได้แก่ การนำทางไปยังหน้าเว็บ การคลิกองค์ประกอบ การพิมพ์ลงในช่องกรอก และการอ่านสิ่งที่อยู่บนหน้าจอ

คุณไม่ต้องติดตั้งหรือตั้งค่าตัวใดเลย ทั้งสองจะเชื่อมต่ออัตโนมัติเมื่อ Perch เริ่มทำงาน

เครื่องมือปรากฏต่อโมเดลอย่างไร

เมื่อเซิร์ฟเวอร์ MCP เชื่อมต่อ Perch จะอ่านรายการเครื่องมือของเซิร์ฟเวอร์และแปลงเครื่องมือแต่ละตัวเป็นนิยามที่โมเดลใช้ได้ รูปแบบการตั้งชื่อคือ mcp__<serverName>__<toolName> ตัวอย่างเช่น การค้นหาคดีของ CourtListener จะกลายเป็น mcp__courtlistener__search_cases และแสดงอยู่ข้างเครื่องมือในตัวอย่าง readLocalFile หรือ webSearch

โมเดลมองเครื่องมือเหล่านี้เท่าเทียมกับเครื่องมือในตัว เรียกใช้ได้ในลูปเดียวกับเครื่องมืออื่นๆ และผลลัพธ์จะกลับมาเป็นเนื้อหาที่มีโครงสร้าง ซึ่ง Perch อ้างอิงและนำไปใช้ต่อได้

config ระดับ global และระดับโฟลเดอร์

เซิร์ฟเวอร์ MCP ตั้งค่าได้สองระดับ

ระดับ global ไฟล์ที่ ~/.perch/mcp.json ใช้กับทุกเซสชันของ Perch บนเครื่องของคุณ เซิร์ฟเวอร์ค่าเริ่มต้นถูกตั้งค่าไว้ที่นี่
ระดับโฟลเดอร์ ไฟล์ .perch/mcp.json ภายในโฟลเดอร์เวิร์กสเปซของคุณ ใช้เฉพาะเมื่อคุณทำงานในโฟลเดอร์นั้น config ระดับโฟลเดอร์จะมีผลเหนือ config ระดับ global ตามชื่อเซิร์ฟเวอร์ คุณจึงแทนที่เซิร์ฟเวอร์ระดับ global ด้วยตัวอื่นสำหรับโปรเจกต์ที่เจาะจงได้

รองรับการแทนค่าตัวแปรสภาพแวดล้อม ถ้าเซิร์ฟเวอร์ต้องใช้คีย์ API คุณอ้างถึงคีย์นั้นเป็น ${YOUR_API_KEY} ใน config ได้ แล้ว Perch จะแทนค่าจากสภาพแวดล้อมของคุณ

เพิ่มเซิร์ฟเวอร์ของคุณเอง

หากต้องการเพิ่มเซิร์ฟเวอร์ MCP ให้แก้ไข ~/.perch/mcp.json (สำหรับระดับ global) หรือ .perch/mcp.json ในโฟลเดอร์เวิร์กสเปซของคุณ (สำหรับโปรเจกต์ที่เจาะจง) โครงสร้างเป็นแบบนี้

{
  "servers": {
    "my-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@some-org/some-mcp-server"],
      "env": {
        "API_KEY": "${MY_API_KEY}"
      }
    }
  }
}

รองรับ transport สามประเภท

stdio รันโปรเซสในเครื่อง ต้องมี command และมี args และ env หรือไม่ก็ได้
http เชื่อมต่อกับ endpoint HTTP ระยะไกล ต้องมี url และมี headers หรือไม่ก็ได้
sse เชื่อมต่อกับ endpoint SSE ระยะไกล ต้องมี url และมี headers หรือไม่ก็ได้

หลังแก้ไข config แล้ว ให้รีสตาร์ต Perch หรือรันคำสั่ง reconnect เซิร์ฟเวอร์ใหม่จะเชื่อมต่อเมื่อเปิดครั้งถัดไป

MCP อยู่ตรงไหนในระบบ

MCP มีไว้สำหรับระบบที่ทำงานอยู่ซึ่งแทนด้วยไฟล์ในโฟลเดอร์ไม่ได้ ถ้าข้อมูลอยู่บนดิสก์ของคุณแล้วในรูปสเปรดชีต PDF หรือ CSV Perch จะอ่านโดยตรงผ่าน folder bridge ส่วน MCP มีไว้สำหรับทุกอย่างที่เหลือ ได้แก่ ฐานข้อมูลภายนอก API และบริการที่ต้องมีโปรเซสทำงานอยู่หรือต้องยืนยันตัวตน

เฉพาะเดสก์ท็อปและ CLI

เซิร์ฟเวอร์ MCP ใช้ได้บน Perch Terminal Desktop และ CLI เว็บแชตไม่เชื่อมต่อกับเซิร์ฟเวอร์ MCP

Operator และเอเจนต์

วิธีที่ Perch ทำได้มากกว่าแชต ทั้งอ่านไฟล์ รันการวิเคราะห์ และประสานงานเวิร์กเกอร์

ความปลอดภัยและข้อมูล

วิธีที่ Perch จัดการไฟล์และข้อมูลของคุณ และสิ่งที่ถูกประมวลผลนอกอุปกรณ์ของคุณ