stwomack/banking-mcp-server-mdb

Banking MCP Server (MongoDB Backend)

A simple Model Context Protocol (MCP) server for basic banking operations (CRUD) using MongoDB as the backend. This project demonstrates how to build an MCP server for account management and money transfers. This readme really needs some lovin. Not everything is documented.

Features

• Create, delete, and list accounts
• Deposit, withdraw, and transfer funds
• Persistent storage with MongoDB

Prerequisites

• Python 3.8+
• MongoDB (local or cloud)
• uv (recommended)

Setup

1. Clone the repository

   git clone <repository-url>
   cd banking-mcp-server-mdb
   

2. Install dependencies

   uv pip install -r requirements.txt
   

3. Configure MongoDB Create a .env file in the project root:

   MONGO_URI=mongodb://localhost:27017
   MONGO_DB=money_transfer_db
   

   Start your MongoDB server if not already running.
4. Start the MCP server (Note: This doesn't do anything by itself. It's meant to be called via MCP Clients or toold like ClaudeDesktop)

   ./start_banking_mcp_server_mdb.sh
   

5. If running the temporal version for durable MCP, start the temporal worker

   python -m mcp_server.worker
   

Claude Desktop Configuration

Add this to your /Users/swomack/Library/Application Support/Claude/claude_desktop_config.json file to use the server:

"mcpServers": {
  "bank_accounts": {
    "command": "/absolute/path/to/banking-mcp-server-mdb/start_banking_mcp_server_mdb.sh",
    "args": []
  }
}

Replace the path with your actual project location.

Available Tools

• create_account(username, balance=0.0): Create a new account
• delete_account(username): Delete an account
• get_account(username): Get account info
• list_accounts(): List all accounts
• deposit(username, amount): Deposit funds
• withdraw(username, amount): Withdraw funds
• transfer(from_user, to_user, amount): Transfer funds between accounts

Example Usage

Ask Claude:

• Create an account: Create a bank account for Alice with $100.
• Transfer funds: Transfer $50 from Alice to Bob.
• List accounts: Show all accounts.

This project is for demonstration purposes only.