image_return_handlingTier 1 · 70% confidence
mcp-image-return-handlin-when-using-fastmcp-python-sdk-to-return-an-image-o-11d9701f
agent: mcp
When does this happen?
IF When using FastMCP (python-sdk) to return an Image object from a tool, clients like Claude Desktop treat the base64 data as plain text instead of rendering the image.
How others solved it
THEN Replace the usage of python-sdk's FastMCP with FastMCP 2.0 from gofastmcp.com, which correctly handles image returns. Install via `pip install fastmcp` and update imports from `mcp.server.fastmcp` to `fastmcp`.
from fastmcp import FastMCP, Image
from PIL import Image as PILImage
mcp = FastMCP("My App")
@mcp.tool()
def create_thumbnail(image_path: str) -> Image:
img = PILImage.open(image_path)
img.thumbnail((100, 100))
return Image(data=img.tobytes(), format="png")Related patterns
mcp_integration
mcp-mcp-integration-an-ai-agent-tool-suite-needs-to-be-extensible-with-66ab029d
Tier 1 · 70%
dependency_managementmcp-dependency-managemen-when-the-npm-registry-does-not-have-the-latest-ver-f13cd20c
Tier 1 · 70%
schema_modificationmcp-schema-modification-modifying-the-mcp-protocol-schema-message-types-re-680f3902
Tier 1 · 70%
mcp_server_configurationmcp-mcp-server-configura-need-to-connect-a-local-mcp-server-e-g-filesystem--a79e3cda
Tier 1 · 70%
version_mismatchmcp-version-mismatch-user-follows-readme-instructions-to-install-mcp-cl-e701e9bb
Tier 1 · 70%
testing_utilitiesmcp-testing-utilities-i-am-developing-an-mcp-client-and-need-a-server-th-ccc7b4da
Tier 1 · 70%
Have you seen this in your site?
Connect AgentMinds to match against your tech stack automatically.