💰 Ingat Uang MCP

MCP (Model Context Protocol) Server untuk aplikasi Ingat Uang. Memungkinkan LLM seperti Claude, GPT, atau Kiro untuk membaca dan menganalisis data keuangan Anda melalui API yang aman.

🚀 Quick Start dengan NPX

Tidak perlu install, langsung pakai!

1. Buat API Key

1. Buka https://ingat-uang.vercel.app
2. Login → Settings → API Keys
3. Create New API Key
4. Copy API Key

2. Konfigurasi Kiro/Claude Desktop

Edit .kiro/settings/mcp.json:

{
  "mcpServers": {
    "ingat-uang": {
      "command": "npx",
      "args": [
        "-y",
        "ingat-uang-mcp",
        "--api-key=your-api-key-here"
      ],
      "disabled": false,
      "autoApprove": [
        "get-transactions",
        "get-transaction-summary",
        "get-subscriptions"
      ]
    }
  }
}

Note: Default API URL adalah https://ingat-uang.vercel.app. Untuk development lokal, tambahkan --api-url=http://localhost:3000

3. Restart & Use!

Restart Kiro/Claude Desktop, lalu tanya:

• "Berapa total pengeluaran saya bulan ini?"
• "Subscription apa saja yang aktif?"
• "Tampilkan 5 transaksi terakhir"

📚 Dokumentasi Lengkap

• NPX Usage Guide - Panduan lengkap menggunakan dengan npx
• Security - Mengapa menggunakan API lebih aman
• Setup Guide - Panduan setup lengkap

🎯 Features

8 Tools untuk LLM

1. get-transactions - Ambil transaksi dengan filter
2. get-transaction-summary - Ringkasan income/expense
3. get-subscriptions - List subscription
4. get-subscription-costs - Hitung biaya subscription
5. get-split-bills - List split bills
6. get-split-bill-detail - Detail split bill
7. get-spending-by-category - Statistik per kategori
8. get-monthly-trends - Tren bulanan

3 Resources

1. ingat-uang://categories - Daftar kategori
2. ingat-uang://subscriptions/stats - Statistik subscription
3. ingat-uang://dashboard/stats - Dashboard stats

🔒 Security

✅ Authentication via API Key ✅ Authorization per user ✅ Audit trail lengkap ✅ No direct database access ✅ HTTPS encryption (production)

Lihat SECURITY.md untuk detail.

🌐 Environments

Production (Default)

{
  "args": ["-y", "ingat-uang-mcp", "--api-key=your-key"]
}

Uses: https://ingat-uang.vercel.app

Development (Local)

{
  "args": [
    "-y", 
    "ingat-uang-mcp", 
    "--api-url=http://localhost:3000",
    "--api-key=your-key"
  ]
}

🛠️ Local Development

Jika ingin modify source code:

git clone https://github.com/yourusername/ingat-uang-mcp
cd ingat-uang-mcp/service
npm install
npm run build
npm run dev

📝 License

MIT

🤝 Contributing

Contributions welcome! Please read our contributing guidelines.

📞 Support

• 📦 NPM Package
• 🐛 Report Issues
• 💬 Discussions
• 🌐 Website