Skip to main content
Glama
bdeda
by bdeda

maya_mcp

FastMCP-based Model Context Protocol (MCP) server for Autodesk Maya. This server enables AI assistants and other MCP clients to interact with an active Maya session, control scene objects, and perform common 3D operations.

Features

  • FastMCP Framework: Built on FastMCP for easy tool, resource, and prompt registration

  • Maya Integration: Communicate with active Maya sessions via maya.cmds API

  • Flexible Deployment: Can be started from within Maya or from a mayapy process

  • Extensible: Easy to add new tools, resources, and prompts

Installation

Development Installation

# Using pip pip install -e . # Using uv uv pip install -e .

Requirements

  • Python 3.10+ (3.11+ recommended)

  • FastMCP >= 2.0.0

  • Autodesk Maya (for running the server with Maya)

Usage

Starting the Server from Maya

  1. Open Maya

  2. In the Maya Script Editor, run:

import sys sys.path.insert(0, r'F:\git\maya_mcp\src\py') # Adjust path as needed import maya_mcp maya_mcp.__main__.main()

Starting the Server from mayapy

# Using mayapy directly mayapy -m maya_mcp # Or if installed as a package mayapy -c "from maya_mcp import mcp; mcp.run()"

Starting as a Standalone Script

If installed via pip/uv:

maya-mcp

Note: The server will warn if Maya is not available, but some tools may not work.

Available Tools

Server Status

  • get_server_status() - Get the status of the Maya MCP server

Scene Operations

  • get_selection() - Get currently selected objects

  • select_objects(names) - Select objects by name

  • clear_selection() - Clear the current selection

More tools will be added as the project develops.

Project Structure

maya_mcp/ ├── src/ │ └── py/ │ └── maya_mcp/ │ ├── __init__.py # Main FastMCP server setup │ ├── __main__.py # Entry point for running the server │ ├── server.py # Core server setup and status tools │ ├── tools/ # Tool implementations │ │ ├── __init__.py │ │ └── scene.py # Scene manipulation tools │ ├── resources/ # Resource implementations │ │ └── __init__.py │ └── prompts/ # Prompt templates │ └── __init__.py ├── tests/ # Unit tests (to be added) ├── pyproject.toml # Project configuration ├── README.md # This file └── AGENTS.md # AI agent guidance

Development

See AGENTS.md for detailed guidance on developing and extending the Maya MCP server.

Running Tests

# Install dev dependencies pip install -e ".[dev]" # Run tests pytest tests/ # With coverage pytest tests/ --cov=src/py/maya_mcp --cov-report=term-missing

License

Apache License 2.0

Author

Ben Deda

-
security - not tested
F
license - not found
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/bdeda/maya_mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server