Banking Assistant (Metabind demo)

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

Bản demo Metabind Finance

Trợ lý tài chính cá nhân không có bản ghi hội thoại. Ứng dụng hỏi một câu hỏi khi khởi động và sử dụng câu trả lời được hiển thị làm màn hình chính; mọi câu hỏi tiếp theo mở trên một bề mặt được thiết kế riêng. Cùng một trợ lý chạy gốc trên iOS và Android từ một định nghĩa ứng dụng MCP.

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

Bản demo Finance, chạy trong ứng dụng iOS.

Metabind là gì

Metabind xây dựng các tác nhân trả lời ngay trong giao diện người dùng của sản phẩm bạn, không phải trong cửa sổ trò chuyện: các giao diện tương tác đưa khách hàng thẳng đến những gì họ cần, với thương hiệu họ đã biết. Nó được xây dựng từ giao diện người dùng, hệ thống thiết kế và API mà ứng dụng đã có. Không cần viết lại. Nó được quản trị, chỉ hiển thị các thành phần bạn đã phê duyệt, được thực thi trên mọi lần hiển thị. Và nó được lưu trữ: bạn định nghĩa các công cụ, chúng tôi chạy máy chủ. Cùng một tác nhân chạy bên trong các ứng dụng iOS, Android và web của bạn, cũng như trên Claude, ChatGPT và mọi máy chủ MCP, theo tiêu chuẩn MCP mở.

Bản demo này cho thấy phần chạy bên trong ứng dụng của bạn, được hiển thị dưới dạng SwiftUI và Jetpack Compose gốc thực sự thông qua SDK Trợ lý.

Bắt đầu miễn phí tại metabind.ai · Đọc tài liệu

Bản demo này là gì

Finance là một trợ lý cố tình không có bản ghi hội thoại. Một câu hỏi được hỏi khi khởi động — "Tiền của tôi đã đi đâu trong tháng này?" — và kết quả MCP được hiển thị chính là màn hình chính. Các câu hỏi sau đến từ một thanh pill ở cuối và mở trong các sheet. Mỗi lượt được định tuyến đến một bề mặt được thiết kế riêng thay vì cuộn qua trong danh sách tin nhắn.

Đây là hình dạng ngược lại với bản demo Retail, nơi bản thân cuộc hội thoại là sản phẩm. Cùng SDK, hai hình dạng — hãy đọc cả hai trước khi quyết định sản phẩm của bạn thuộc loại nào.

Làm việc qua README này từ đầu đến cuối, bạn sẽ có:

• Dự án MCP Finance — phân tích chi tiêu, danh sách giao dịch, đăng ký và xu hướng giá trị tài sản ròng dưới dạng các thành phần BindJS trên dữ liệu tổng hợp — được cài đặt như một dự án trong tổ chức Metabind của riêng bạn.
• Ứng dụng iOS chạy với dự án đó.
• Ứng dụng Android chạy với cùng dự án đó.

Tất cả dữ liệu tài chính đều là tổng hợp. Không có gì ở đây kết nối đến ngân hàng thực, đọc bí mật hoặc gọi máy chủ bên ngoài.

Có gì trong thư mục này

Thư mục	Nội dung
apple/	Ứng dụng iOS trên MetabindAI (MetabindAssistant), SDK được ghim theo thẻ phát hành
android/	Ứng dụng Android trên metabindai-android (MetabindAssistant), SDK được ghim trong danh mục phiên bản
mcp/	Dự án MCP Finance: các thành phần BindJS, công cụ và nguồn dữ liệu tổng hợp

Trước khi bắt đầu

• Tài khoản và tổ chức Metabind — đăng ký tại metabind.ai/signup.

• CLI metabind, phiên bản 0.9.0 trở lên:

  brew install metabindai/tap/metabind
  metabind --version
  

• Khóa API nhà cung cấp LLM (Anthropic, OpenAI hoặc Google). Proxy tác nhân Metabind giữ khóa ở phía máy chủ và chạy cuộc hội thoại với nó — các ứng dụng không bao giờ gửi khóa nhà cung cấp.

• Đối với iOS: Xcode 26+ (ứng dụng nhắm mục tiêu iOS 17+).

• Đối với Android: Android Studio, JDK 17+ và thông tin xác thực GitHub Packages — GitHub yêu cầu xác thực ngay cả để đọc gói công khai.

Phần 1 — cài đặt dự án MCP

Chạy các lệnh này từ thư mục này (finance/).

1. Đăng ký tại metabind.ai nếu bạn chưa đăng ký — điều đó tạo tài khoản và tổ chức của bạn. Sau đó đăng nhập vào CLI và chọn tổ chức để cài đặt:

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

   use --clear quan trọng nếu bạn đã sử dụng CLI trước đó. install trong bước 3 tạo một dự án chỉ khi chưa có dự án nào được liên kết, và cài đặt vào dự án đã liên kết nếu có — sau bản demo Retail, chẳng hạn. Chỉ đặt tổ chức không giải phóng một dự án đã liên kết trước đó; metabind status hiển thị phạm vi đang hoạt động.

2. Xem cây khai báo những gì trước khi tạo bất cứ thứ gì:

   metabind inspect --dir mcp
   

   Finance khai báo không có bí mật và không có cuộc gọi ra ngoài — inspect là cách bạn xác nhận điều đó từ chính cây.

3. Cài đặt:

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

   install tạo id mới cho mọi thứ nó tạo, ghi lại nơi cây đến từ và chỉ tạo bản nháp — không có gì phục vụ lưu lượng truy cập cho đến khi bạn xuất bản. Sao chép id dự án mà nó in ra.

4. Phạm vi CLI đến dự án mới và đặt khóa LLM của tác nhân:

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

5. Xuất bản:

   metabind publish
   

6. Tạo khóa API mà các ứng dụng đăng nhập bằng:

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

   Sao chép giá trị ngay bây giờ — nó chỉ được hiển thị một lần, khi tạo. Một khóa API Metabind xác thực cả proxy Tác nhân và máy chủ MCP.

7. Tùy chọn, áp dụng cài đặt dự án và hình thu nhỏ. install tạo các thành phần và công cụ; cài đặt trong mcp/metabind.jsonc — hướng dẫn MCP và lời nhắc hệ thống của tác nhân — được áp dụng bởi 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 viết lại các bản nháp công cụ, vì vậy hãy xuất bản một lần nữa để phát hành chúng.

   project get không phải là trang trí. project update từ chối ghi một thực thể mà CLI chưa đọc gần đây, để nó có thể biết rằng dự án không bị thay đổi bên dưới bạn:

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

   Một dự án bạn vừa cài đặt chưa bao giờ được đọc, vì vậy lần cập nhật đầu tiên gặp phải điều này nếu không có nó.

   Đặt thumbnailUrl sau khi đẩy, không phải trước: project update thay thế các đối tượng cài đặt lồng nhau thay vì hợp nhất chúng, vì vậy viết settings.mcp ở đây sẽ làm mất các hướng dẫn push vừa được áp dụng.

[!NOTE] Cấu hình các máy khách với id tổ chức và dự án mà install đã in — id nội bộ ổn định, không phải slug tổ chức.

Phần 2 — chạy ứng dụng iOS

1. Tạo cấu hình cục bộ được gitignore từ mẫu của nó:

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

2. Điền các id từ Phần 1:

   FINANCE_DEMO_ORG_ID = your_stable_internal_org_id
   FINANCE_DEMO_PROJECT_ID = your_project_id
   

   Để trống FINANCE_DEMO_API_KEY — bạn sẽ nhập khóa khi khởi chạy lần đầu. FINANCE_DEMO_BUNDLE_ID và DEVELOPMENT_TEAM chỉ quan trọng đối với các bản dựng thiết bị đã ký.

3. Mở dự án và chạy nó (⌘R) trên trình mô phỏng iOS 17+:

   open MetabindFinanceDemo.xcodeproj
   

4. Nhập khóa API Metabind của bạn trên màn hình khởi động và nhấn Bắt đầu. Màn hình chính tải bằng cách hỏi "Tiền của tôi đã đi đâu trong tháng này?". Nhấn vào một câu hỏi tiếp theo được gợi ý hoặc Hỏi bất cứ điều gì để mở câu trả lời tiếp theo trong một sheet.

Để biết cách ký, Xcode Cloud, TestFlight và cách tích hợp hoạt động, hãy xem README của ứng dụng iOS.

Phần 3 — chạy ứng dụng Android

1. Cung cấp thông tin xác thực Gradle cho GitHub Packages, dưới dạng biến môi trường (GITHUB_ACTOR / GITHUB_TOKEN) hoặc trong ~/.gradle/gradle.properties:

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

2. Tạo cấu hình cục bộ được gitignore từ mẫu của nó và điền cùng các id từ Phần 1:

   cd android
   cp local.properties.example local.properties
   

3. Xây dựng, cài đặt và khởi chạy trên thiết bị hoặc trình mô phỏng (API 26+, với WebView JavaScript Sandbox khả dụng — BindJS chạy mã thành phần trong androidx.javascriptengine):

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

4. Nhập khóa API Metabind của bạn và nhấn Bắt đầu — cùng luồng khởi chạy lần đầu như iOS.

Để biết kiến trúc Compose và các khác biệt có chủ đích so với ứng dụng iOS, hãy xem README của ứng dụng Android.

Tiếp theo là gì

• Chỉnh sửa dự án MCP — thay đổi một thành phần, xác thực, đẩy và xuất bản, với các tập lệnh đối chiếu giữ cho các số liệu của mỗi thẻ khớp nhau.
• Bản demo Retail — cùng SDK với hình dạng ngược lại: bản ghi hội thoại là sản phẩm.
• Metabind cho Apple và Metabind cho Android — cài đặt SDK và tài liệu tham khảo API.
• docs.metabind.ai — các hướng dẫn đầy đủ.

Giấy phép

Apache 2.0. Xem LICENSE và NOTICE tại thư mục gốc của kho lưu trữ; apple/, android/ và mcp/ mang bản sao riêng của chúng vì chúng được thiết kế để sao chép ra làm bộ khởi đầu.