1- # Django Telescope
1+ # Django AI Boost
22
3- <!-- mcp-name: io.github.raisiqueira/django-telescope -->
3+ <!-- mcp-name: io.github.raisiqueira/django-ai-boost -->
44
55A Model Context Protocol (MCP) server for Django applications, inspired by [ Laravel Boost] ( https://github.com/laravel/boost ) . This server exposes Django project information through MCP tools, enabling AI assistants to better understand and interact with Django codebases.
66
@@ -41,11 +41,11 @@ A Model Context Protocol (MCP) server for Django applications, inspired by [Lara
4141<details >
4242<summary >Click to view screenshots</summary >
4343
44- ### Django Telescope in Action
44+ ### Django AI Boost in Action
4545
46- ![ Django Telescope Example] ( ./assets/example_mcp01.png )
46+ ![ Django AI Boost Example] ( ./assets/example_mcp01.png )
4747
48- * Django Telescope MCP server providing Django project introspection through AI assistants (Example using [ OpenCode] ( https://opencode.ai/ ) )*
48+ * Django AI Boost MCP server providing Django project introspection through AI assistants (Example using [ OpenCode] ( https://opencode.ai/ ) )*
4949
5050</details >
5151
@@ -55,10 +55,10 @@ A Model Context Protocol (MCP) server for Django applications, inspired by [Lara
5555
5656``` bash
5757# Using uv (recommended)
58- uv pip install django-telescope
58+ uv pip install django-ai-boost
5959
6060# Or with pip
61- pip install django-telescope
61+ pip install django-ai-boost
6262```
6363
6464### For Development
@@ -67,8 +67,8 @@ If you want to contribute or run the latest development version:
6767
6868``` bash
6969# Clone the repository
70- git clone https://github.com/vinta/django-telescope .git
71- cd django-telescope
70+ git clone https://github.com/vinta/django-ai-boost .git
71+ cd django-ai-boost
7272
7373# Install uv if you haven't already
7474# On macOS/Linux:
@@ -81,7 +81,7 @@ powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
8181uv sync --dev
8282
8383# Verify installation
84- uv run django-telescope --help
84+ uv run django-ai-boost --help
8585```
8686
8787## Usage
@@ -93,13 +93,13 @@ The server requires access to your Django project's settings:
9393``` bash
9494# Set the Django settings module
9595export DJANGO_SETTINGS_MODULE=myproject.settings
96- django-telescope
96+ django-ai-boost
9797
9898# Or specify settings directly
99- django-telescope --settings myproject.settings
99+ django-ai-boost --settings myproject.settings
100100
101101# Run with SSE transport (default is stdio)
102- django-telescope --settings myproject.settings --transport sse
102+ django-ai-boost --settings myproject.settings --transport sse
103103```
104104
105105## AI Tools Setup
@@ -115,7 +115,7 @@ Add to your Claude Desktop configuration:
115115{
116116 "mcpServers" : {
117117 "django" : {
118- "command" : " django-telescope " ,
118+ "command" : " django-ai-boost " ,
119119 "args" : [" --settings" , " myproject.settings" ],
120120 "env" : {
121121 "DJANGO_SETTINGS_MODULE" : " myproject.settings" ,
@@ -136,9 +136,9 @@ Add to your Claude Desktop configuration:
136136``` json
137137{
138138 "mcpServers" : {
139- "django-telescope " : {
139+ "django-ai-boost " : {
140140 "command" : " uv" ,
141- "args" : [" run" , " django-telescope " , " --settings" , " myproject.settings" ],
141+ "args" : [" run" , " django-ai-boost " , " --settings" , " myproject.settings" ],
142142 "env" : {
143143 "DJANGO_SETTINGS_MODULE" : " myproject.settings"
144144 }
@@ -160,7 +160,7 @@ OpenAI ChatGPT Desktop supports MCP servers. Add to your configuration file:
160160{
161161 "mcpServers" : {
162162 "django" : {
163- "command" : " django-telescope " ,
163+ "command" : " django-ai-boost " ,
164164 "args" : [" --settings" , " myproject.settings" ],
165165 "env" : {
166166 "DJANGO_SETTINGS_MODULE" : " myproject.settings"
@@ -179,7 +179,7 @@ OpenAI ChatGPT Desktop supports MCP servers. Add to your configuration file:
179179``` json
180180{
181181 "django" : {
182- "command" : " django-telescope " ,
182+ "command" : " django-ai-boost " ,
183183 "args" : [" --settings" , " myproject.settings" ],
184184 "env" : {
185185 "DJANGO_SETTINGS_MODULE" : " myproject.settings"
@@ -196,7 +196,7 @@ Add to your Zed MCP configuration (`~/.config/zed/mcp.json`):
196196{
197197 "servers" : {
198198 "django" : {
199- "command" : " django-telescope " ,
199+ "command" : " django-ai-boost " ,
200200 "args" : [" --settings" , " myproject.settings" ],
201201 "env" : {
202202 "DJANGO_SETTINGS_MODULE" : " myproject.settings"
@@ -212,10 +212,10 @@ For any MCP-compatible client, you can run the server manually:
212212
213213``` bash
214214# Standard I/O transport (default)
215- django-telescope --settings myproject.settings
215+ django-ai-boost --settings myproject.settings
216216
217217# Server-Sent Events transport
218- django-telescope --settings myproject.settings --transport sse
218+ django-ai-boost --settings myproject.settings --transport sse
219219```
220220
221221## Available Tools and Prompts
@@ -318,7 +318,7 @@ uv run python test_server.py
318318
319319# Run the MCP server with the test project
320320export PYTHONPATH=" ${PYTHONPATH} :./fixtures/testproject"
321- uv run django-telescope --settings testproject.settings
321+ uv run django-ai-boost --settings testproject.settings
322322
323323# Run linter
324324uv run ruff check .
@@ -340,7 +340,7 @@ Make sure you've set the `DJANGO_SETTINGS_MODULE` environment variable or used t
340340
341341``` bash
342342export DJANGO_SETTINGS_MODULE=myproject.settings
343- django-telescope
343+ django-ai-boost
344344```
345345
346346### PYTHONPATH Issues
@@ -349,7 +349,7 @@ If Django can't find your project modules, add your project directory to PYTHONP
349349
350350``` bash
351351export PYTHONPATH=" ${PYTHONPATH} :/path/to/your/project"
352- django-telescope --settings myproject.settings
352+ django-ai-boost --settings myproject.settings
353353```
354354
355355Or in your MCP client configuration:
@@ -365,12 +365,12 @@ Or in your MCP client configuration:
365365
366366### MCP Server Not Connecting
367367
368- 1 . Check that the ` django-telescope ` command is accessible in your PATH
368+ 1 . Check that the ` django-ai-boost ` command is accessible in your PATH
3693692 . Verify your MCP client configuration file syntax is valid JSON
3703703 . Check the logs in your AI tool (usually in settings or help menu)
3713714 . Try running the server manually to see any error messages:
372372 ``` bash
373- django-telescope --settings myproject.settings
373+ django-ai-boost --settings myproject.settings
374374 ```
375375
376376### Database Connection Issues
@@ -400,8 +400,8 @@ We welcome contributions from the community! Whether it's bug fixes, new feature
4004001 . ** Fork the repository** on GitHub
4014012 . ** Clone your fork** locally:
402402 ``` bash
403- git clone https://github.com/YOUR_USERNAME/django-telescope .git
404- cd django-telescope
403+ git clone https://github.com/YOUR_USERNAME/django-ai-boost .git
404+ cd django-ai-boost
405405 ```
4064063 . ** Install development dependencies** :
407407 ``` bash
@@ -435,7 +435,7 @@ We welcome contributions from the community! Whether it's bug fixes, new feature
435435
436436 # Test with the fixture project
437437 export PYTHONPATH=" ${PYTHONPATH} :./fixtures/testproject"
438- uv run django-telescope --settings testproject.settings
438+ uv run django-ai-boost --settings testproject.settings
439439 ```
4404404 . ** Commit your changes** :
441441 ``` bash
0 commit comments