Banking Assistant (Metabind demo)

官方

基於Metabind建置的互動式MCP應用程式示範：個人財務答案以UI卡片形式（淨資產、支出、訂閱）呈現在Claude和ChatGPT中，並原生支援iOS/Android應用程式。

你可以用 Banking Assistant (Metabind Demo) MCP 做什麼？

支出明細 — 詢問「我這個月的錢都花到哪裡去了？」即可取得以呈現的明細作為主畫面，而非聊天回覆。
交易清單 — 開啟專用介面，查看示範合成資料流中的交易。
訂閱檢視 — 在專屬介面查看定期訂閱，不必捲動對話紀錄。
淨資產趨勢 — 查看以合成資料呈現的淨資產趨勢元件。
後續問題 — 點選建議的後續問題或「隨便問」，即可在工作表中開啟下一個答案。

託管 MCP 伺服器

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

可安裝到 Claude Code、Codex、Cursor 等客戶端

文件

Metabind Finance 示範

沒有聊天記錄的個人理財助理。應用程式啟動時會提出一個問題，並將呈現的答案作為主畫面；每個後續問題都會在專為其打造的介面中開啟。同一個助理透過一份 MCP App 定義，原生執行於 iOS 和 Android。

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

在 iOS 應用程式中執行的 Finance 示範。

什麼是 Metabind

Metabind 打造的代理會在你產品自己的 UI 中回答問題，而不是在聊天視窗中：互動式介面讓客戶直接前往他們想要的內容，並使用他們熟悉的品牌。它以應用程式現有的 UI、設計系統和 API 打造。無須重寫。它受到治理，只會呈現你核准的元件，並在每次呈現時強制執行。它也採代管服務：你定義工具，我們執行伺服器。同一個代理可在你自己的 iOS、Android 和網頁應用程式中執行，也可在 Claude、ChatGPT 和所有 MCP 主機中執行，並採用開放的 MCP 標準。

此示範展示在你自己的應用程式中執行的部分，透過 Assistant SDK 呈現為真正的原生 SwiftUI 和 Jetpack Compose。

在 metabind.ai 免費開始使用 · 閱讀文件

此示範的內容

Finance 是一個刻意不保留對話記錄的助理。啟動時會提出一個問題——「這個月我的錢都花到哪裡去了？」——而呈現的 MCP 結果就是主畫面。之後的問題可從底部的膠囊列提出，並在工作表中開啟。每一輪對話都會導向專為其打造的介面，而不是在訊息清單中向下捲動。

這與Retail 示範的形式正好相反；在那裡，對話本身就是產品。兩者使用相同的 SDK，卻有兩種形式——決定哪一種適合你的產品之前，請先閱讀兩者。

從頭到尾完成這份 README，你將取得：

Finance MCP 專案——以合成資料為基礎，透過 BindJS 元件呈現支出明細、交易清單、訂閱項目和淨資產趨勢——並安裝為你自己的 Metabind 組織中的專案。
連線至該專案執行的 iOS 應用程式。
連線至同一專案執行的 Android 應用程式。

所有財務資料都是合成資料。此處的任何內容都不會連線至真實銀行、讀取機密或呼叫外部主機。

此資料夾的內容

目錄	內容
`apple/`	使用 `MetabindAI` (`MetabindAssistant`) 的 iOS 應用程式，SDK 以發行標籤固定版本
`android/`	使用 `metabindai-android` (`MetabindAssistant`) 的 Android 應用程式，SDK 在版本目錄中固定版本
`mcp/`	Finance MCP 專案：BindJS 元件、工具和合成資料來源

開始之前

Metabind 帳戶和組織——請前往 metabind.ai/signup 註冊。

metabind CLI，版本 0.9.0 或更新版本：

brew install metabindai/tap/metabind
metabind --version

LLM 供應商 API 金鑰（Anthropic、OpenAI 或 Google）。Metabind Agent proxy 會在伺服器端保管金鑰，並使用它執行對話——應用程式絕不會附帶供應商金鑰。
iOS：Xcode 26+（應用程式的目標版本為 iOS 17+）。
Android：Android Studio、JDK 17+ 和 GitHub Packages 認證資料—— 即使要讀取公開套件，GitHub 仍要求進行驗證。

第 1 部分 — 安裝 MCP 專案

請在此目錄（finance/）中執行以下指令。

如果你尚未註冊，請前往 metabind.ai 註冊—— 這會建立你的帳戶和組織。接著登入 CLI，並選擇要安裝至的組織：
```
metabind auth login
metabind org list
metabind use --clear
metabind use --org <org-id>
```
如果你之前用過 CLI，use --clear 就很重要。第 3 步的 install 只會在尚未綁定專案時建立專案，否則會安裝至已綁定的專案——例如在 Retail 示範之後。只設定組織不會釋出先前綁定的專案；metabind status 會顯示目前作用範圍。
建立任何內容之前，先查看樹狀結構宣告了什麼：
```
metabind inspect --dir mcp
```
Finance 未宣告任何機密或外部呼叫——inspect 可讓你直接從樹狀結構確認這一點。
安裝：
```
metabind install --dir mcp --name "Banking Assistant" --yes
```
install 會為建立的所有項目產生新的 ID、記錄樹狀結構的來源，並且只建立草稿——發布之前不會提供任何流量服務。請複製它顯示的專案 ID。

將 CLI 的作用範圍設為新專案，並設定代理的 LLM 金鑰：

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

發布：
```
metabind publish
```
產生應用程式登入時使用的 API 金鑰：
```
metabind api-key create --name "Banking Assistant"
```
請立即複製金鑰值——建立時只會顯示一次。同一個 Metabind API 金鑰可同時驗證 Agent proxy 和 MCP 伺服器。
可選擇套用專案設定和縮圖。install 會建立元件和工具；mcp/metabind.jsonc 中的設定——MCP 指示和代理系統提示——則由 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：project update 會取代巢狀設定物件，而不是合併它們，因此在此寫入 settings.mcp 會移除 push 剛套用的指示。

[!NOTE] 請使用 install 顯示的組織和專案 ID 設定用戶端—— 使用穩定的內部 ID，而非組織代稱。

第 2 部分 — 執行 iOS 應用程式

從範本建立會被 git 忽略的本機設定檔：

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

填入第 1 部分取得的 ID：
```
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 只適用於簽署裝置版本。
開啟專案，並在 iOS 17+ 模擬器上執行（⌘R）：
```
open MetabindFinanceDemo.xcodeproj
```
在啟動畫面輸入你的 Metabind API 金鑰，然後點選 Start。主畫面會以提出 「這個月我的錢都花到哪裡去了？」 載入。點選建議的後續問題或 Ask anything，即可在工作表中開啟下一個答案。

如需簽署、Xcode Cloud、TestFlight 以及整合方式的資訊，請參閱 iOS 應用程式的 README。

第 3 部分 — 執行 Android 應用程式

為 GitHub Packages 提供 Gradle 認證資料，可使用環境變數 (GITHUB_ACTOR / GITHUB_TOKEN)，或設定於 ~/.gradle/gradle.properties：
```
gpr.user=your-github-username
gpr.key=your-github-token
```
從範本建立會被 git 忽略的本機設定檔，並填入第 1 部分取得的相同 ID：
```
cd android
cp local.properties.example local.properties
```
在裝置或模擬器上建置、安裝並啟動（API 26+，且須提供 WebView JavaScript Sandbox——BindJS 會在其中執行元件程式碼 androidx.javascriptengine）：
```
./gradlew :app:installDebug
adb shell am start -n ai.metabind.finance.demo/.MainActivity
```
輸入你的 Metabind API 金鑰並點選 Start——首次啟動流程與 iOS 相同。

如需 Compose 架構以及與 iOS 應用程式刻意採取的不同做法，請參閱 Android 應用程式的 README。

接下來可以做什麼

編輯 MCP 專案——修改元件、驗證、推送並發布——以及確保每張卡片的數字一致的 BEGIN SHARED FEED 規則。
Retail 示範——使用相同 SDK，形式卻正好相反：對話記錄就是產品。
Apple 版 Metabind 和 Android 版 Metabind—— SDK 安裝和 API 參考資料。
docs.metabind.ai——完整指南。

授權條款

Apache 2.0。請參閱儲存庫根目錄中的 LICENSE 和 NOTICE；apple/、android/ 和 mcp/ 各自附有副本，因為它們是設計來複製出去作為起始範本使用的。