Banking Assistant (Metabind demo)

npx add-mcp 'https://mcp.metabind.ai/IgJH0BzIn4LlfnCbcDc7/projects/GLbHk5i3GLlIYcF63XFl'

เดโม Metabind Finance

ผู้ช่วยด้านการเงินส่วนบุคคลที่ไม่มีบทสนทนาในแชต เมื่อเปิดแอป แอปจะถามหนึ่งคำถามและใช้คำตอบที่แสดงผลเป็นหน้าจอหลัก ส่วนคำถามติดตามผลแต่ละข้อจะเปิดบนหน้าจอที่ออกแบบมาโดยเฉพาะ ผู้ช่วยตัวเดียวกันทำงานแบบเนทีฟบน iOS และ Android จากนิยาม MCP App เดียว

https://github.com/user-attachments/assets/9a840b88-dc88-4ab4-927e-0a8dc651dbe3

เดโม Finance ที่ทำงานอยู่ในแอป iOS

Metabind คืออะไร

Metabind สร้างเอเจนต์ที่ตอบคำถามใน UI ของผลิตภัณฑ์คุณเอง ไม่ใช่ในหน้าต่างแชต: อินเทอร์เฟซแบบโต้ตอบที่พาลูกค้าไปยังสิ่งที่ต้องการโดยตรง ในแบรนด์ที่พวกเขาคุ้นเคยอยู่แล้ว สร้างขึ้นจาก UI, design system และ API ที่แอปมีอยู่แล้ว ไม่ต้องเขียนใหม่ อยู่ภายใต้การกำกับดูแล โดยแสดงผลเฉพาะคอมโพเนนต์ที่คุณอนุมัติ และบังคับใช้ทุกครั้งที่แสดงผล อีกทั้งยังโฮสต์ให้ด้วย: คุณกำหนดเครื่องมือ ส่วนเรารันเซิร์ฟเวอร์ เอเจนต์ตัวเดียวกันทำงานได้ทั้งในแอป iOS, Android และเว็บของคุณ รวมถึง Claude, ChatGPT และ MCP host ทุกตัว บนมาตรฐาน MCP แบบเปิด

เดโมนี้แสดงการทำงานภายในแอปของคุณเอง โดยแสดงผลเป็น SwiftUI และ Jetpack Compose แบบเนทีฟจริงผ่าน Assistant SDK

เริ่มใช้ฟรีที่ metabind.ai · อ่านเอกสาร

เดโมนี้คืออะไร

Finance เป็นผู้ช่วยที่ตั้งใจออกแบบให้ไม่มีบทสนทนาในแชต เมื่อเปิดแอป ระบบจะถามหนึ่งคำถาม — "เดือนนี้เงินของฉันหมดไปกับอะไรบ้าง?" — และผลลัพธ์ MCP ที่แสดงผล ก็คือ หน้าจอหลัก คำถามถัดไปจะมาจากแถบปุ่มรูปแคปซูลด้านล่างและเปิดในชีต แต่ละรอบจะถูกส่งไปยังหน้าจอที่ออกแบบมาโดยเฉพาะ แทนที่จะเลื่อนดูในรายการข้อความ

รูปแบบนี้ตรงข้ามกับ เดโม Retail ที่ตัวบทสนทนาเองคือผลิตภัณฑ์ ใช้ SDK ชุดเดียวกัน แต่มีสองรูปแบบ — อ่านทั้งสองเดโมก่อนตัดสินใจว่ารูปแบบใดเหมาะกับผลิตภัณฑ์ของคุณ

เมื่อทำตาม README นี้ตั้งแต่ต้นจนจบ คุณจะได้:

• โปรเจกต์ Finance MCP — การแจกแจงค่าใช้จ่าย รายการธุรกรรม การสมัครสมาชิก และแนวโน้มมูลค่าสุทธิในรูปแบบคอมโพเนนต์ BindJS ที่ใช้ข้อมูลสังเคราะห์ — ติดตั้งเป็นโปรเจกต์ในองค์กร Metabind ของคุณเอง
• แอป iOS ที่ทำงานกับโปรเจกต์นั้น
• แอป Android ที่ทำงานกับโปรเจกต์เดียวกัน

ข้อมูลทางการเงินทั้งหมดเป็นข้อมูลสังเคราะห์ ไม่มีส่วนใดเชื่อมต่อกับธนาคารจริง อ่านข้อมูลลับ หรือเรียกใช้ host ภายนอก

มีอะไรอยู่ในโฟลเดอร์นี้

ไดเรกทอรี	เนื้อหา
apple/	แอป iOS บน MetabindAI (MetabindAssistant) โดย SDK ถูกตรึงไว้ตาม release tag
android/	แอป Android บน metabindai-android (MetabindAssistant) โดย SDK ถูกตรึงไว้ใน version catalog
mcp/	โปรเจกต์ Finance MCP: คอมโพเนนต์ BindJS เครื่องมือ และฟีดข้อมูลสังเคราะห์

ก่อนเริ่มต้น

• บัญชีและองค์กร Metabind — สมัครได้ที่ metabind.ai/signup.

• CLI ของ metabind เวอร์ชัน 0.9.0 ขึ้นไป:

  brew install metabindai/tap/metabind
  metabind --version
  

• API key ของผู้ให้บริการ LLM (Anthropic, OpenAI หรือ Google) พร็อกซี Metabind Agent จะเก็บคีย์ไว้ฝั่งเซิร์ฟเวอร์และใช้รันบทสนทนา — แอปจะไม่มีคีย์ของผู้ให้บริการอยู่ภายใน

• สำหรับ iOS: Xcode 26 ขึ้นไป (แอปกำหนดเป้าหมาย iOS 17 ขึ้นไป)

• สำหรับ Android: Android Studio, JDK 17 ขึ้นไป และข้อมูลรับรอง GitHub Packages — GitHub กำหนดให้ยืนยันตัวตนแม้ต้องการอ่านแพ็กเกจสาธารณะ

ส่วนที่ 1 — ติดตั้งโปรเจกต์ MCP

เรียกใช้คำสั่งเหล่านี้จากไดเรกทอรีนี้ (finance/)

1. หากยังไม่ได้สมัคร ให้สมัครที่ metabind.ai — ระบบจะสร้างบัญชีและองค์กรให้ จากนั้นลงชื่อเข้าใช้ CLI และเลือกองค์กรที่จะติดตั้ง:

   metabind auth login
   metabind org list
   metabind use --clear
   metabind use --org <org-id>
   

   use --clear สำคัญหากคุณเคยใช้ CLI มาก่อน install ในขั้นตอนที่ 3 จะสร้างโปรเจกต์ก็ต่อเมื่อยังไม่มีโปรเจกต์ที่ผูกอยู่ และจะติดตั้งลงในโปรเจกต์ที่ผูกอยู่แล้วในกรณีอื่น — เช่น หลังจากใช้เดโม Retail การตั้งค่าองค์กรเพียงอย่างเดียวไม่ได้ปล่อยโปรเจกต์ที่ผูกไว้ก่อนหน้านี้ ส่วน metabind status จะแสดงขอบเขตที่ใช้งานอยู่

2. ตรวจดูสิ่งที่ประกาศไว้ในโครงสร้างก่อนสร้างสิ่งใด:

   metabind inspect --dir mcp
   

   Finance ไม่ได้ประกาศข้อมูลลับหรือการเรียกออกไปภายนอก — inspect เป็นวิธียืนยันเรื่องนี้จากโครงสร้างโดยตรง

3. ติดตั้ง:

   metabind install --dir mcp --name "Banking Assistant" --yes
   

   install สร้าง ID ใหม่ให้กับทุกสิ่งที่สร้าง บันทึกที่มาของโครงสร้าง และสร้างเฉพาะฉบับร่างเท่านั้น — จะไม่มีสิ่งใดให้บริการทราฟฟิกจนกว่าคุณจะเผยแพร่ คัดลอก project ID ที่ระบบแสดง

4. กำหนดขอบเขต CLI ให้กับโปรเจกต์ใหม่และตั้งค่า LLM key ของเอเจนต์:

   metabind use --project <project-id>
   echo $ANTHROPIC_API_KEY | metabind agent set --provider anthropic --api-key-stdin
   

5. เผยแพร่:

   metabind publish
   

6. สร้าง API key ที่แอปใช้ลงชื่อเข้าใช้:

   metabind api-key create --name "Banking Assistant"
   

   คัดลอกค่าไว้ตอนนี้ — ระบบจะแสดงให้เห็นเพียงครั้งเดียวตอนสร้าง API key ของ Metabind หนึ่งรายการใช้ยืนยันตัวตนได้ทั้งพร็อกซี Agent และเซิร์ฟเวอร์ MCP

7. หากต้องการ ให้ใช้การตั้งค่าโปรเจกต์และภาพขนาดย่อ install สร้างคอมโพเนนต์และเครื่องมือ ส่วนการตั้งค่าใน mcp/metabind.jsonc — คำแนะนำ MCP และ system prompt ของเอเจนต์ — จะถูกนำไปใช้โดย push:

   metabind asset upload mcp/assets/files/project-thumbnail.png
   metabind sync repair --out mcp --org <org-id> --project <project-id>
   metabind push --out mcp
   metabind project get <project-id>
   metabind project update <project-id> \
     --data '{"settings":{"thumbnailUrl":"<url from asset upload>"}}'
   metabind publish
   

   push เขียนฉบับร่างของเครื่องมือใหม่ ดังนั้นให้เผยแพร่อีกครั้งเพื่อปล่อยใช้งาน

   project get ไม่ใช่ของตกแต่ง project update ปฏิเสธการเขียนเอนทิตีที่ CLI ไม่ได้อ่านเมื่อไม่นานมานี้ เพื่อให้ตรวจสอบได้ว่าโปรเจกต์ไม่ได้เปลี่ยนแปลงไปโดยที่คุณไม่รู้ตัว:

   CONFLICT: Refusing project update <project-id>: no recent read recorded.
   

   โปรเจกต์ที่เพิ่งติดตั้งยังไม่เคยถูกอ่าน ดังนั้นการอัปเดตครั้งแรกจะติดเงื่อนไขนี้หากไม่ได้ทำขั้นตอนดังกล่าวก่อน

   ตั้งค่า thumbnailUrl หลังจาก push ไม่ใช่ก่อนหน้า: project update แทนที่ออบเจ็กต์การตั้งค่าที่ซ้อนกัน แทนที่จะผสานเข้าด้วยกัน ดังนั้นการเขียน settings.mcp ที่นี่จะลบคำแนะนำที่ push เพิ่งนำไปใช้

[!NOTE] กำหนดค่าไคลเอนต์ด้วย ID องค์กรและโปรเจกต์ที่ install แสดง — ใช้ ID ภายในแบบคงที่ ไม่ใช่ slug ขององค์กร

ส่วนที่ 2 — เรียกใช้แอป iOS

1. สร้างไฟล์กำหนดค่าในเครื่องที่ถูกละเว้นจาก Git โดยใช้ไฟล์เทมเพลต:

   cd apple
   cp Config/Local.xcconfig.example Config/Local.xcconfig
   

2. กรอก ID จากส่วนที่ 1:

   FINANCE_DEMO_ORG_ID = your_stable_internal_org_id
   FINANCE_DEMO_PROJECT_ID = your_project_id
   

   เว้น FINANCE_DEMO_API_KEY ไว้ว่าง — คุณจะป้อนคีย์เมื่อเปิดแอปครั้งแรก FINANCE_DEMO_BUNDLE_ID และ DEVELOPMENT_TEAM สำคัญเฉพาะกับบิลด์สำหรับอุปกรณ์ที่ลงนามแล้วเท่านั้น

3. เปิดโปรเจกต์และเรียกใช้ (⌘R) บน iOS 17+ simulator:

   open MetabindFinanceDemo.xcodeproj
   

4. ป้อน Metabind API key บนหน้าจอเปิดแอป แล้วแตะ Start หน้าจอหลักจะโหลดโดยถามว่า "เดือนนี้เงินของฉันหมดไปกับอะไรบ้าง?" แตะคำถามติดตามผลที่แนะนำหรือ Ask anything เพื่อเปิดคำตอบถัดไปในชีต

ดูข้อมูลเกี่ยวกับการลงนาม, Xcode Cloud, TestFlight และวิธีทำงานของการผสานรวมได้ที่ README ของแอป iOS

ส่วนที่ 3 — เรียกใช้แอป Android

1. กำหนดข้อมูลรับรองให้ Gradle สำหรับ GitHub Packages โดยใช้ตัวแปรสภาพแวดล้อม (GITHUB_ACTOR / GITHUB_TOKEN) หรือใน ~/.gradle/gradle.properties:

   gpr.user=your-github-username
   gpr.key=your-github-token
   

2. สร้างไฟล์กำหนดค่าในเครื่องที่ถูกละเว้นจาก Git โดยใช้ไฟล์เทมเพลต แล้วกรอก ID ชุดเดียวกับในส่วนที่ 1:

   cd android
   cp local.properties.example local.properties
   

3. สร้าง ติดตั้ง และเปิดแอปบนอุปกรณ์หรือ emulator (API 26 ขึ้นไป โดยต้องมี WebView JavaScript Sandbox — BindJS เรียกใช้โค้ดคอมโพเนนต์ใน androidx.javascriptengine):

   ./gradlew :app:installDebug
   adb shell am start -n ai.metabind.finance.demo/.MainActivity
   

4. ป้อน Metabind API key แล้วแตะ Start — ขั้นตอนการเปิดแอปครั้งแรกเหมือนกับบน iOS

ดูสถาปัตยกรรม Compose และความแตกต่างที่ตั้งใจให้มีจากแอป iOS ได้ที่ README ของแอป Android

ขั้นต่อไป

• แก้ไขโปรเจกต์ MCP — เปลี่ยนคอมโพเนนต์ ตรวจสอบความถูกต้อง push และเผยแพร่ — รวมถึงกฎ BEGIN SHARED FEED ที่ทำให้ตัวเลขในการ์ดทุกใบสอดคล้องกัน
• เดโม Retail — ใช้ SDK ชุดเดียวกันแต่มีรูปแบบตรงข้าม: บทสนทนาคือตัวผลิตภัณฑ์
• Metabind สำหรับ Apple และ Metabind สำหรับ Android — การติดตั้ง SDK และข้อมูลอ้างอิง API
• docs.metabind.ai — คู่มือฉบับเต็ม

ใบอนุญาต

Apache 2.0 ดู LICENSE และ NOTICE ที่รูทของ repository; apple/, android/ และ mcp/ มีสำเนาของตนเอง เพราะตั้งใจให้คัดลอกออกไปใช้เป็นโปรเจกต์เริ่มต้น