Bank-of-anthos-mcp-server

Mahesh5h9/Bank-of-anthos-mcp-server

3.2

If you are the rightful owner of Bank-of-anthos-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Bank of Anthos MCP Server provides a secure interface for AI assistants to interact with the Bank of Anthos demo banking application, facilitating user management, account operations, transactions, and system monitoring.

Tools
7
Resources
0
Prompts
0

Bank of Anthos MCP Server

A Model Context Protocol (MCP) server that provides comprehensive access to Google Cloud's Bank of Anthos demo banking application APIs.

Purpose

This MCP server provides a secure interface for AI assistants to interact with the Bank of Anthos banking simulation, including user management, account operations, transactions, and system monitoring.

Features

Current Implementation

  • frontend_login - Login to the frontend with username and password
  • frontend_logout - Logout from the frontend session
  • frontend_signup - Sign up for a new account with user details
  • frontend_get_balance - Get account balance from home page
  • frontend_get_transaction_history - Get transaction history table HTML
  • frontend_deposit - Make external deposits to accounts
  • frontend_payment - Make internal payments between accounts

Prerequisites

  • Python 3.13+
  • Docker (optional, for containerized deployment)
  • Bank of Anthos application running and accessible

Installation

Local Development

# Install dependencies
pip install -r requirements.txt

# Or using uv
uv pip install -r requirements.txt

# Run the server
python bank_of_anthos.py

Docker Deployment

# Build and run with docker-compose
docker-compose up -d --build

# Check logs
docker logs bank-of-anthos-mcp

# Stop the container
docker-compose down

Configuration

Environment Variables

MCP Client Configuration

Add to your MCP client configuration for Claude-Desktop:

{
  "mcpServers": {
    "bank-of-anthos": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:8000/mcp"
      ]
    }
  }
}

Usage Examples

Once running, the server will be available at: http://localhost:8000/mcp

You can ask your AI assistant:

  • "Login to the bank with username testuser and password test123"
  • "Check my account balance"
  • "Show my transaction history"
  • "Make a payment of $100 to account 1234567890"
  • "Make a deposit of $500 from external account"
  • "Sign up for a new account"
  • "Logout from the bank"

Architecture

AI Assistant → MCP Client → Bank of Anthos MCP Server → Bank of Anthos Application
                                      ↓
                            Streamable HTTP Transport
                                 (Port 8000)

API Endpoints Covered

Frontend Service

  • POST /login - Login operations
  • POST /logout - Logout
  • POST /signup - User registration
  • GET /home - Home page (balance & transactions)
  • POST /deposit - External deposits
  • POST /payment - Internal payments

Development

Local Testing

# Set environment variable for testing
export BANK_OF_ANTHOS_URL="https://your-bank-url"

# Run with streamable-http transport
python bank_of_anthos.py
# Server will be available at: http://localhost:8000/mcp

# Test the server endpoints
curl -X POST http://localhost:8000/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

Adding New Tools

  1. Add the function to bank_of_anthos.py
  2. Decorate with @mcp.tool()
  3. Add proper validation and error handling
  4. Update this README with the new tool

Troubleshooting

Connection Errors

  • Verify Bank of Anthos application is running
  • Check if the application URL is accessible
  • Ensure the server is running on port 8000

Authentication Errors

  • Verify login credentials are correct
  • Check if session cookies are being stored
  • Try logging in again

Docker Issues

  • Check container logs: docker logs bank-of-anthos-mcp
  • Verify port 8000 is not in use
  • Rebuild the image: docker-compose up -d --build

Security Considerations

  • Session cookies stored in memory (cleared on logout)
  • Sensitive data logged to stderr only
  • Input validation for all user inputs
  • No credentials hardcoded in the application

Bank of Anthos Reference

This MCP server is designed to work with Google Cloud's Bank of Anthos demo application:

License

MIT License