MCP Server - Python FastAPI

Overview

This is a MCP (Minimal Core Platform) Server implemented in Python using FastAPI. It simulates a basic banking system with endpoints for account management, deposits, withdrawals, balance inquiries, and transaction history.

---

Hosted URL

https://mcp-server-m5d2.onrender.com

---

Cloud Provider

Render - Publicly accessible deployment.

---

Technology Stack

• Python 3.13
• FastAPI
• Uvicorn
• SQLAlchemy (SQLite/PostgreSQL compatible)
• Pydantic
• python-dotenv

---

Endpoints

1. Create Account

POST /account Creates a new bank account.

Request Body Example:

{
  "name": "John Doe",
  "email": "john@example.com"
}

Response Example:

{
  "name": "alex roy",
  "email": "example@gmail.com",
  "created_at": "2025-12-27T17:43:36",
  "balance": 0,
  "id": "05997aae-a545-4157-9118-99fd2ec7b4c7"
}

---

2. Deposit

POST /deposit/{account_id} Adds funds to an existing account.

Request Body Example:

{
  "amount": 500.0
}

Response Example:

{
  "account_id": "uuid",
  "balance": 500.0
}

---

3. Withdraw

POST /withdraw/{account_id} Removes funds from an existing account.

Request Body Example:

{
  "amount": 100.0
}

Response Example:

{
  "account_id": "uuid",
  "balance": 400.0
}

---

4. Balance Inquiry

GET /balance/{account_id} Retrieves the current balance of the account.

Response Example:

{
  "account_id": "uuid",
  "balance": 400.0
}

---

5. Transaction History

GET /transactions/{account_id} Returns recent transactions for the account.

Response Example:

[
  {
    "transaction_id": "uuid",
    "type": "deposit",
    "amount": 500.0,
    "timestamp": "2025-12-27T12:00:00"
  },
  {
    "transaction_id": "uuid",
    "type": "withdraw",
    "amount": 100.0,
    "timestamp": "2025-12-27T12:10:00"
  }
]

---

Database & ACID Properties

The MCP Server uses SQLAlchemy to interact with a relational database (SQLite by default). The database logic ensures the operations:

• Isolation: Simultaneous transactions on different accounts are isolated; concurrent operations do not interfere.
• Durability: Once a transaction is committed, it persists even if the server crashes.

---

Running Locally

Prerequisites

• Python 3.13
• pip

Install Dependencies

pip install -r requirements.txt

Start Server

uvicorn main:app --host 0.0.0.0 --port 8000

Visit http://127.0.0.1:8000/docs for Swagger UI.

---

ArmorIQ Scanning

• Tested with ArmorIQ Sentry VS Code extension (Sentry-MCP-Endpoint-Scan, Sentry-Scan-WorkSpace-For-MCP-Security-Issue)
• Tested with ArmorIQ Landing Page scanner
• Endpoints are exposed publicly for the purpose of security scanning

---

GitHub Repository

https://github.com/shreyash1231/MCP-Server.git

---