local-commands-python.md

Commands for local development

Prerequisites

• Python 3.12+
• uv

Virtual Environment Commands

Initialize the virtual environment

On Windows:

.\scripts\init-venv.bat

On macOS/Linux:

./scripts/init-venv.sh

Then, you can configure the virtual environment in Cursor (VS Code) to run the code directly in the IDE.

Enter the virtual environment

On Windows:

.\scripts\enter-venv.bat

On macOS/Linux:

./scripts/enter-venv.sh

Add the package (after entering the virtual environment)

uv add <package_name>

Remove the package (after entering the virtual environment)

uv remove <package_name>

If you need other commands, please refer to the uv documentation.

Run the server

Ensure that you are in the app directory, and entered the virtual environment.

Run the MCP server (with inspector)

mcp dev run_mcp.py

Run the MCP server (without inspector)

uv run run_mcp.py

Run the overall server (FastAPI + MCP server)

uv run run_server.py

pytest Commands

Run all tests without entering the virtual environment

On Windows:

.\scripts\pytest.bat

On macOS/Linux:

./scripts/pytest.sh

Run the test (after entering the virtual environment)

Assume that you are in the app directory.

To run all tests:

pytest

To run a specific test, for example:

pytest tests/foo.py::test_bar -v

If you need to view more detailed logs, you can use the command with -s and -vv:

pytest -s tests/foo.py::test_bar -vv