FastMCP DevContainer — MyDevAssistant

A simple FastMCP server that exposes developer tools (math, file access, and note creation) to AI models via the Model Context Protocol (MCP).

---

Prerequisites

• Python 3.12+
• uv (fast Python package manager)

Or, to use the devcontainer (no local setup needed):

• Docker Desktop
• VS Code with the Dev Containers extension

---

Option 1 — Dev Container (recommended)

1. Open the project folder in VS Code.
2. When prompted, click Reopen in Container (or run the command Dev Containers: Reopen in Container from the Command Palette).
3. VS Code will build the container and run the setup script automatically. When the terminal shows FastMCP installed successfully!, you're ready.

---

Option 2 — Local setup

# 1. Create and activate a virtual environment
python -m venv .venv
source .venv/bin/activate        # Linux / macOS
# .venv\Scripts\activate         # Windows (PowerShell)

# 2. Install dependencies
pip install uv
uv pip install fastmcp ruff black

---

Running the server

fastmcp run src/server.py

Or directly with Python:

python src/server.py

The server communicates over stdio by default, which is how MCP clients (e.g. Claude Desktop) connect to it.

---

Connecting to Claude Desktop

Add the following to your Claude Desktop MCP config (usually claude_desktop_config.json):

{
  "mcpServers": {
    "MyDevAssistant": {
      "command": "python",
      "args": [
        "<absolute-path-to>/src/server.py"
      ]
    }
  }
}

Replace <absolute-path-to> with the full path to this project folder.

---

Available tools

Tool	Description
add(a, b)	Add two numbers
multiply(a, b)	Multiply two numbers
list_files()	List all files in the workspace
read_file(filename)	Read the contents of a workspace file
create_note(title, content)	Create a markdown note in example_notes/

---

Project structure

fastmcp-devcontainer/
├── .devcontainer/
│   ├── devcontainer.json        # Dev container configuration
│   └── postCreateCommand.sh     # Container setup script
├── example_notes/               # Notes created by the create_note tool
├── src/
│   └── server.py                # FastMCP server and tool definitions
└── README.md