Up Bank MCP Server

🚀 Up Banking MCP Server

このModel Context Protocol (MCP)サーバーは、Up Banking APIとの統合を提供します。このサーバーを使用すると、ClaudeがあなたのUp銀行のデータ（口座、取引、カテゴリなど）とやり取りできます。

✨ 主な機能

• 口座管理：すべての口座を一覧表示し、口座の詳細と残高を取得します。
• 取引履歴：柔軟なフィルタリング（日付範囲、ステータス、カテゴリ、タグ）で取引を照会します。
• カテゴリ情報：Upの支出カテゴリにアクセスし、取引に関する洞察を深めます。
• 型安全：信頼性と開発者体験のためにTypeScriptで構築されています。
• セキュア：Upの個人用アクセストークンを使用して認証します。

📋 前提条件

• Node.js 18以上
• Up銀行の口座
• Upの個人用アクセストークン

📦 インストール

1. このリポジトリをクローンまたはダウンロードします。

cd up-mcp-server

2. 依存関係をインストールします。

npm install

3. サーバーをビルドします。

npm run build

🔑 Up APIトークンの取得方法

1. 携帯電話でUpアプリを開きます。
2. 右にスワイプして「データ共有」を選択します。
3. 「個人用アクセストークン」をタップします。
4. 「トークンを生成する」を選択します。
5. トークンの有効期限を選択します。
6. 指示に従ってトークンを安全にコピーします。

⚠️ 重要提示

トークンを安全に保管してください！決して共有したり、バージョン管理にコミットしたりしないでください。

⚙️ 設定

Claude Desktopの設定

Claude Desktopの設定ファイルに以下を追加します。

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "up-banking": {
      "command": "node",
      "args": ["/absolute/path/to/up-mcp-server/build/index.js"],
      "env": {
        "UP_API_TOKEN": "your_up_api_token_here"
      }
    }
  }
}

/absolute/path/to/up-mcp-serverをこのディレクトリの実際のパスに置き換え、your_up_api_token_hereをあなたのUp個人用アクセストークンに置き換えてください。

代替方法：npxを使用する

npxを使用してサーバーを直接実行することもできます。

{
  "mcpServers": {
    "up-banking": {
      "command": "npx",
      "args": ["-y", "/absolute/path/to/up-mcp-server"],
      "env": {
        "UP_API_TOKEN": "your_up_api_token_here"
      }
    }
  }
}

💻 使用例

設定が完了したら、Claudeに以下のような質問をすることができます。

• 「現在の口座残高はいくらですか？」
• 「先月のすべての取引を表示してください。」
• 「今週、レストランでいくら使ったか教えてください。」
• 「すべての貯蓄口座を一覧表示してください。」
• 「支出口座の保留中の取引は何ですか？」
• 「'vacation'というタグが付いたすべての取引を表示してください。」

🛠️ 開発

ウォッチモード

自動再コンパイルを行う開発用には、以下のコマンドを使用します。

npm run dev

接続のテスト

設定後、Claude Desktopを再起動して以下を試してみてください。

Can you ping the Up API to verify the connection?

🐞 トラブルシューティング

"UP_API_TOKEN environment variable is required"

Claude Desktopの設定ファイルのenvセクションにUp APIトークンを追加したことを確認してください。

"Up API error: 401"

あなたのAPIトークンが無効または期限切れです。Upアプリで新しいトークンを生成してください。

Claudeにサーバーが表示されない場合

1. build/index.jsへのパスが絶対パスで正しいことを確認します。
2. 設定ファイルのJSON構文が有効であることを確認します。
3. Claude Desktopを完全に再起動します。
4. Claudeのログにエラーメッセージがないか確認します。

🔒 セキュリティに関する注意事項

• あなたのUp APIトークンは、銀行データへの完全な読み取りアクセスを許可します。
• トークンをバージョン管理にコミットしないでください。
• 環境変数または安全な設定管理を使用してください。
• トークンのアクセスはUpアプリでいつでも取り消すことができます。
• トークンに有効期限を設定することを検討してください。

🚧 APIのレート制限

Up APIにはレート制限があります。制限を超えると、サーバーはエラーメッセージを返します。ページネーションとフィルタリングを使用して、API呼び出しを最小限に抑えてください。

🤝 コントリビューション

これは主な読み取り操作をカバーする基本的な実装です。潜在的な機能強化点は以下の通りです。

• リアルタイムの取引通知用のウェブフックサポートを追加する。
• 取引のカテゴリ分類の更新を実装する。
• 添付ファイル/レシートのサポートを追加する。
• カーソルベースのブラウジングによるページネーションをサポートする。

📄 ライセンス

MIT

🔗 関連リンク

• Up Banking API Documentation
• Model Context Protocol Documentation
• Up Bank