project/
│
├── app/
│   ├── __init__.py
│   └── server.py
│
├── client/
│   └── mcp_client.py
│
├── tests/
│   └── test_mcp_tools.py
│
├── requirements.txt
├── pyproject.toml
└── README.md

python --version

Python 3.14.x

python -m venv .venv
.venv\Scripts\activate

python -m venv .venv
source .venv/bin/activate

pip install -r requirements.txt

pip install fastmcp pytest pytest-asyncio

python app/server.py

INFO: FastMCP server started
INFO: Listening on http://0.0.0.0:8000/mcp

curl http://localhost:8000/mcp

fastmcp list http://localhost:8000/mcp

health
say_hello
generate_uuid

python client/mcp_client.py

Available Tools:
- health
- say_hello
- generate_uuid

Health Response:
{'status': 'healthy'}

Hello Response:
{'message': 'Hello Satheesh'}

UUID Response:
{'uuid': 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'}

import asyncio

from fastmcp import Client


async def main():
    async with Client("http://localhost:8000/mcp") as client:

        health = await client.call_tool("health")
        print(health.data)

        hello = await client.call_tool(
            "say_hello",
            {"name": "Satheesh"}
        )
        print(hello.data)

        uuid_result = await client.call_tool(
            "generate_uuid"
        )
        print(uuid_result.data)


if __name__ == "__main__":
    asyncio.run(main())

pytest -v

tests/test_mcp_tools.py::test_health PASSED
tests/test_mcp_tools.py::test_say_hello PASSED
tests/test_mcp_tools.py::test_generate_uuid PASSED

await client.call_tool("health")

{
  "status": "healthy"
}

await client.call_tool(
    "say_hello",
    {
        "name": "Satheesh"
    }
)

{
  "message": "Hello Satheesh"
}

await client.call_tool(
    "generate_uuid"
)

{
  "uuid": "550e8400-e29b-41d4-a716-446655440000"
}

@mcp.tool
def say_hello(name: str) -> dict:
    return {
        "message": f"Hello {name}"
    }

python app/server.py

netstat -ano | findstr 8000

pip show fastmcp

fastmcp >= 3.x