mcp-server-3Dpicture MCP Server

What is mcp-server-3Dpicture MCP Server?

It is a TypeScript-based MCP server that converts a 2D image of people into a 3D picture. It uses an OpenAI API to generate the 3D effect and optionally adds a text caption under the photo frame.

How to use mcp-server-3Dpicture MCP Server?

Install dependencies with npm install, build with npm run build, then configure the server in your MCP client (e.g., Cursor) by adding an entry to ~/.cursor/mcp.json with the node command, the build path, and the required OPENAI_API_KEY and OPENAI_BASE_URL environment variables. The server exposes a tool called generate_3Dpicture that accepts a required url (the image URL) and an optional text (caption).

Key features of mcp-server-3Dpicture MCP Server

• Tool: generate_3Dpicture for 2D‑to‑3D conversion
• Supports optional text caption under the photo
• Requires OpenAI API key and base URL
• Written in TypeScript for reliable execution
• Configurable with a 180‑second tool call timeout

Use cases of mcp-server-3Dpicture MCP Server

• Transform a portrait photo into a 3D‑looking picture
• Add a custom text caption below the 3D image
• Integrate 3D image generation into Cursor or any MCP‑compatible IDE

FAQ from mcp-server-3Dpicture MCP Server

What dependencies does the server need?

It requires an OpenAI API key and base URL, set via the environment variables OPENAI_API_KEY and OPENAI_BASE_URL. No additional external services are needed.

Where is the server configuration placed for Cursor?

On macOS, the configuration file is located at ~/.cursor/mcp.json. You must add an entry with the command, args, and env fields as shown in the README.

Is there a timeout for tool calls?

Yes, the tool has a configurable timeout; the example uses toolCallTimeoutMillis: 180000 (3 minutes) to allow enough time for the 3D generation.

How can I debug the server?

You can use the MCP Inspector by running npm run inspector, which provides a URL for debugging the server over stdio.

What parameters does the generate_3Dpicture tool accept?

It requires a url (the picture URL) and accepts an optional text for a caption under the photo frame.