Skip to content

Adds Banksy FastMCP tech stack summary #6

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
willik wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Adds Banksy FastMCP tech stack summary #6

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 34 additions & 0 deletions fastmcp-migration/tech-stack-summary.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
# Banksy Tech Stack Summary

**Author:** Willis Kirkham
**Date:** 2026-03-11

---

Banksy is Mural's MCP server platform.

## What It Is

- Single-process **FastMCP** server that provides MCP access to Mural for both IDE clients and backend services
- Curated MCP tools with controlled naming, descriptions, and visibility
- Handles user authentication and per-request Mural token injection

## Stack

| Category | Choice | Notes |
| ---------------------- | ------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| Language | **Python >=3.12** | MCP ecosystem is Python-first; 3.12 for performance and `TaskGroup` |
| MCP framework | **FastMCP >=3.1** | Dominant framework (~19.5k stars); composition, DI, test utilities built in |
| Project and deps | **uv** | FastMCP uses it; native workspaces, single lockfile, fast (over Poetry) |
| Linting and formatting | **Ruff** | Single tool replacing Black + isort + flake8; same vendor as uv |
| Type checking | **Pyright** (editor) + **mypy** w/ Pydantic plugin (CI) | Pyright for DX speed; mypy catches Pydantic edge cases |
| Testing | **pytest** + **pytest-asyncio** | Required by FastMCP's in-memory test client |
| Database | **PostgreSQL** via **SQLAlchemy 2.0 async** (asyncpg) | Fully async ORM; token and session storage. Falls back to raw asyncpg + dbmate if schema stays simple |
| Migrations | **Alembic** | Standard companion to SQLAlchemy; replaced by dbmate if we drop to raw asyncpg |
| HTTP client | **httpx** + **httpx-retries** | Required by FastMCP internals; async, transport-level retries |
| Configuration | **pydantic-settings** | Pydantic-native env/file config; same pattern as FastMCP |
| Git hooks | **pre-commit** | Ecosystem standard; Ruff-only on commit, type checks in CI |

## Known Limitations

- **`structuredContent` not yet supported by FastMCP** — tools return JSON as stringified text; revisit when FastMCP adds support