Skip to main content

MCP server providing a stateful Django shell for LLM assistants.

Project description

mcp-django-shell

Django shell tools for the mcp-django Model Context Protocol server.

⚠️ Security Warning

This package provides unrestricted shell access to your Django project. It executes arbitrary Python code with full access to your database and file system.

NEVER install this in production environments!

Installation

This package is distributed as an optional extra of the main mcp-django package:

pip install "mcp-django[shell]"

Features

The mcp-django-shell package adds two tools to the base MCP server:

  • django_shell - Execute Python code in a persistent Django shell session
  • django_reset - Reset the session, clearing all variables and imports

These tools enable LLM assistants to:

  • Write and execute Python code directly in your Django environment
  • Maintain state between calls (imports, variables persist)
  • Query and modify your database using the Django ORM
  • Debug and test code interactively

Documentation

For full documentation, configuration, and usage instructions, see the main package:

https://github.com/joshuadavidthomas/mcp-django

License

mcp-django-shell is licensed under the MIT license. See the LICENSE file for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_django_shell-0.9.0.tar.gz (6.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcp_django_shell-0.9.0-py3-none-any.whl (8.8 kB view details)

Uploaded Python 3

File details

Details for the file mcp_django_shell-0.9.0.tar.gz.

File metadata

  • Download URL: mcp_django_shell-0.9.0.tar.gz
  • Upload date:
  • Size: 6.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.11

File hashes

Hashes for mcp_django_shell-0.9.0.tar.gz
Algorithm Hash digest
SHA256 cf7155bac042af8d02809176d141d8c29d931d65dd2a496f2cd24ffb973bd463
MD5 255f674b845dd49cb0e44a77be14b1f0
BLAKE2b-256 0d2a11a5df0d07fa842207ebeeaebdb5224860a9acb3d11d10ae8946fdf18622

See more details on using hashes here.

File details

Details for the file mcp_django_shell-0.9.0-py3-none-any.whl.

File metadata

File hashes

Hashes for mcp_django_shell-0.9.0-py3-none-any.whl
Algorithm Hash digest
SHA256 fc220840de1190f61630964aa37a4bf6d0b419cbeda7af60a03b9c5d90c2a350
MD5 4eb9d5c56f074fb724835c489813aae4
BLAKE2b-256 2c51762a106f919591b5a4864eaf857cf1f858aa27937f28d132e09cad5b0481

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page