gibson-cli 0.7.7__tar.gz → 0.8.0__tar.gz

{gibson_cli-0.7.7/gibson_cli.egg-info → gibson_cli-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: gibson-cli
-Version: 0.7.7
+Version: 0.8.0
 Summary: Gibson Command Line Interface
 Author-email: GibsonAI <noc@gibsonai.com>
 Project-URL: Homepage, https://gibsonai.com/
@@ -11,55 +11,60 @@ Project-URL: Changelog, https://github.com/gibsonai/cli/releases
 Classifier: Operating System :: OS Independent
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3.9
-Requires-Python: >=3.9
+Classifier: Programming Language :: Python :: 3.10
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 Requires-Dist: annotated-types==0.6.0
-Requires-Dist: anyio==4.3.0
+Requires-Dist: anyio==4.9.0
 Requires-Dist: certifi==2024.2.2
 Requires-Dist: charset-normalizer==3.3.2
 Requires-Dist: click==8.1.7
 Requires-Dist: dnspython==2.6.1
-Requires-Dist: email_validator==2.1.1
+Requires-Dist: email-validator==2.1.1
 Requires-Dist: exceptiongroup==1.2.0
-Requires-Dist: Faker==24.0.0
-Requires-Dist: faker_sqlalchemy==0.10.2208140
-Requires-Dist: fastapi==0.111.0
+Requires-Dist: faker==24.0.0
+Requires-Dist: faker-sqlalchemy==0.10.2208140
+Requires-Dist: fastapi==0.115.12
 Requires-Dist: fastapi-cli==0.0.2
 Requires-Dist: h11==0.14.0
 Requires-Dist: httpcore==1.0.5
 Requires-Dist: httptools==0.6.1
 Requires-Dist: httpx==0.27.0
+Requires-Dist: httpx-sse==0.4.0
 Requires-Dist: idna==3.6
 Requires-Dist: iniconfig==2.0.0
-Requires-Dist: Jinja2==3.1.4
+Requires-Dist: jinja2==3.1.4
 Requires-Dist: markdown-it-py==3.0.0
-Requires-Dist: MarkupSafe==2.1.5
+Requires-Dist: markupsafe==2.1.5
+Requires-Dist: mcp==1.6.0
 Requires-Dist: mdurl==0.1.2
 Requires-Dist: orjson==3.10.3
-Requires-Dist: packaging==23.2
+Requires-Dist: packaging==24.2
 Requires-Dist: pluggy==1.4.0
-Requires-Dist: pydantic==2.6.1
-Requires-Dist: pydantic_core==2.16.2
+Requires-Dist: pydantic==2.11.0
+Requires-Dist: pydantic-core==2.33.0
+Requires-Dist: pydantic-settings==2.8.1
 Requires-Dist: pyfiglet==1.0.2
-Requires-Dist: Pygments==2.18.0
-Requires-Dist: PyMySQL==1.1.0
+Requires-Dist: pygments==2.18.0
+Requires-Dist: pymysql==1.1.0
 Requires-Dist: pytest==8.0.1
 Requires-Dist: python-dateutil==2.9.0.post0
 Requires-Dist: python-dotenv==1.0.1
 Requires-Dist: python-multipart==0.0.9
-Requires-Dist: PyYAML==6.0.1
+Requires-Dist: pyyaml==6.0.1
 Requires-Dist: requests==2.31.0
 Requires-Dist: rich==13.9.2
 Requires-Dist: shellingham==1.5.4
 Requires-Dist: six==1.16.0
 Requires-Dist: sniffio==1.3.1
-Requires-Dist: SQLAlchemy==1.4.41
-Requires-Dist: starlette==0.37.2
+Requires-Dist: sqlalchemy==1.4.41
+Requires-Dist: sse-starlette==2.2.1
+Requires-Dist: starlette==0.46.1
 Requires-Dist: textual==0.83.0
 Requires-Dist: tomli==2.0.1
 Requires-Dist: typer==0.12.3
-Requires-Dist: typing_extensions==4.9.0
+Requires-Dist: typing-extensions==4.13.0
+Requires-Dist: typing-inspection==0.4.0
 Requires-Dist: ujson==5.9.0
 Requires-Dist: urllib3==1.26.6
 Requires-Dist: uvicorn==0.29.0
@@ -74,12 +79,12 @@ Requires-Dist: yaspin==3.1.0
 # Gibson CLI
 
 [![PyPI - Version](https://img.shields.io/pypi/v/gibson-cli)](https://pypi.org/project/gibson-cli/)
-![Python 3.9+](https://img.shields.io/badge/Python-3.9%2B-blue)
+![Python 3.10+](https://img.shields.io/badge/Python-3.10%2B-blue)
 [![Docs](https://img.shields.io/badge/Docs-https://docs.gibsonai.com-green)](https://docs.gibsonai.com)
 
 ## Prerequisites
 
-Gibson currently works on projects that use Python 3.9 or greater, MySQL, SQLAlchemy, Pydantic, Alembic, FastAPI and pytest. It is capable of building a complete application, from database to API end points, using these frameworks. Future enhancements of Gibson will include support for more languages and frameworks.
+Gibson currently works on projects that use Python 3.10 or greater, MySQL, SQLAlchemy, Pydantic, Alembic, FastAPI and pytest. It is capable of building a complete application, from database to API end points, using these frameworks. Future enhancements of Gibson will include support for more languages and frameworks.
 
 Portions of the Gibson backend code are written by Gibson.  So far, versus a human developer, it has coded 66% of the software and did so in seconds. To get started, read the instructions here.
 
@@ -191,7 +196,7 @@ All of Gibson's configuration files and caches are stored in `$HOME/.gibson`. Us
 
 ## Currently Supported Software
 
-- Python 3.9 or greater
+- Python 3.10 or greater
 - MySQL
 - SQLAlchemy
 - Pydantic
@@ -375,6 +380,25 @@ At the moment, just refer to the base-level schema directly.
   - e.g. `gibson q add nickname to sql://user`
   - `gibson code model user`
 
+### Setting up the MCP server with Cursor
+
+Head over to `Cursor Settings` > `MCP` and click `Add new MCP server`
+
+Update the configuration to look like the following:
+
+```json
+{
+  "mcpServers": {
+    "gibson": {
+      "command": "gibson",
+      "args": ["mcp", "run"]
+    }
+  }
+}
+```
+
+That's it! Just make sure you're logged in to the CLI (if you're reading this, you've likely already run `gibson auth login`) and then Cursor's agents will have access to the Gibson MCP server to create + update projects on your behalf, explain how to interact with the database + hosted APIs, and even write working code for you.
+
 ## Contributing
 
 - Clone this repository somewhere in your file system

{gibson_cli-0.7.7 → gibson_cli-0.8.0}/README.md

@@ -4,12 +4,12 @@
 # Gibson CLI
 
 [![PyPI - Version](https://img.shields.io/pypi/v/gibson-cli)](https://pypi.org/project/gibson-cli/)
-![Python 3.9+](https://img.shields.io/badge/Python-3.9%2B-blue)
+![Python 3.10+](https://img.shields.io/badge/Python-3.10%2B-blue)
 [![Docs](https://img.shields.io/badge/Docs-https://docs.gibsonai.com-green)](https://docs.gibsonai.com)
 
 ## Prerequisites
 
-Gibson currently works on projects that use Python 3.9 or greater, MySQL, SQLAlchemy, Pydantic, Alembic, FastAPI and pytest. It is capable of building a complete application, from database to API end points, using these frameworks. Future enhancements of Gibson will include support for more languages and frameworks.
+Gibson currently works on projects that use Python 3.10 or greater, MySQL, SQLAlchemy, Pydantic, Alembic, FastAPI and pytest. It is capable of building a complete application, from database to API end points, using these frameworks. Future enhancements of Gibson will include support for more languages and frameworks.
 
 Portions of the Gibson backend code are written by Gibson.  So far, versus a human developer, it has coded 66% of the software and did so in seconds. To get started, read the instructions here.
 
@@ -121,7 +121,7 @@ All of Gibson's configuration files and caches are stored in `$HOME/.gibson`. Us
 
 ## Currently Supported Software
 
-- Python 3.9 or greater
+- Python 3.10 or greater
 - MySQL
 - SQLAlchemy
 - Pydantic
@@ -305,6 +305,25 @@ At the moment, just refer to the base-level schema directly.
   - e.g. `gibson q add nickname to sql://user`
   - `gibson code model user`
 
+### Setting up the MCP server with Cursor
+
+Head over to `Cursor Settings` > `MCP` and click `Add new MCP server`
+
+Update the configuration to look like the following:
+
+```json
+{
+  "mcpServers": {
+    "gibson": {
+      "command": "gibson",
+      "args": ["mcp", "run"]
+    }
+  }
+}
+```
+
+That's it! Just make sure you're logged in to the CLI (if you're reading this, you've likely already run `gibson auth login`) and then Cursor's agents will have access to the Gibson MCP server to create + update projects on your behalf, explain how to interact with the database + hosted APIs, and even write working code for you.
+
 ## Contributing
 
 - Clone this repository somewhere in your file system

{gibson_cli-0.7.7 → gibson_cli-0.8.0}/bin/build.sh

@@ -1,2 +1,2 @@
 rm -rf dist gibson_cli.egg-info
-python3 -m build
+PYTHONMEM=1G python3 -m build

{gibson_cli-0.7.7 → gibson_cli-0.8.0}/gibson/api/BaseApi.py

@@ -1,4 +1,3 @@
-import os
 import pprint
 
 import requests
@@ -16,6 +15,16 @@ class BaseApi:
     def base_url(self):
         return f"{self.configuration.api_domain()}/{self.VERSION}"
 
+    def delete(self, endpoint):
+        r = requests.delete(self.url(endpoint), headers=self.headers())
+
+        if r.status_code == 401 and self.refresh_auth_tokens():
+            r = requests.delete(self.url(endpoint), headers=self.headers())
+
+        self.__raise_for_status(r)
+
+        return r
+
     def get(self, endpoint):
         r = requests.get(self.url(endpoint), headers=self.headers())
 
@@ -37,7 +46,17 @@ class BaseApi:
 
         return headers
 
-    def post(self, endpoint, json: dict):
+    def patch(self, endpoint, json: dict):
+        r = requests.patch(self.url(endpoint), headers=self.headers(), json=json)
+
+        if r.status_code == 401 and self.refresh_auth_tokens():
+            r = requests.patch(self.url(endpoint), headers=self.headers(), json=json)
+
+        self.__raise_for_status(r)
+
+        return r
+
+    def post(self, endpoint: str = "", json: dict = None):
         r = requests.post(self.url(endpoint), headers=self.headers(), json=json)
 
         if r.status_code == 401 and self.refresh_auth_tokens():
@@ -78,10 +97,9 @@ class BaseApi:
         )
         return True
 
-    def url(self, endpoint):
-        if self.PREFIX:
-            return f"{self.base_url()}/{self.PREFIX}/{endpoint}"
-        return f"{self.base_url()}/{endpoint}"
+    def url(self, endpoint: str):
+        base = f"{self.base_url()}/{self.PREFIX}" if self.PREFIX else self.base_url()
+        return f"{base}/{endpoint}" if endpoint else base
 
     def __raise_for_status(self, r):
         if r.status_code == 401:

gibson_cli-0.8.0/gibson/api/ProjectApi.py

@@ -0,0 +1,46 @@
+from gibson.api.BaseApi import BaseApi
+from gibson.core.Configuration import Configuration
+
+
+class ProjectApi(BaseApi):
+    PREFIX = "project"
+
+    def __init__(self, configuration: Configuration):
+        self.configuration = configuration
+        self.configuration.require_login()
+
+    def list(self):
+        return self.get("all")["projects"]
+
+    def create(self):
+        return self.post().json()
+
+    def database_schema(self, uuid: str):
+        return self.get(f"{uuid}/schema/deployed")
+
+    def lookup(self, uuid: str):
+        return self.get(f"{uuid}")
+
+    def deploy(self, uuid: str):
+        return self.post(f"{uuid}/deploy")
+
+    def mcp(self, uuid: str):
+        return self.get(f"{uuid}/mcp")
+
+    def schema(self, uuid: str):
+        return self.get(f"{uuid}/schema")
+
+    def structure(self, uuid: str):
+        return self.get(f"{uuid}/structure")
+
+    def submit_message(self, uuid: str, message: str):
+        if not message:
+            raise ValueError("Message is required")
+
+        return self.post(f"{uuid}/conversation", {"content": message}).json()
+
+    def update(self, uuid: str, name: str):
+        if not name:
+            raise ValueError("Name is required")
+
+        return self.put(f"{uuid}", {"name": name}).json()

{gibson_cli-0.7.7 → gibson_cli-0.8.0}/gibson/command/Help.py

@@ -3,7 +3,6 @@ from rich.console import Console
 from rich.table import Table
 from rich.text import Text
 
-import gibson.core.Colors as Colors
 from gibson.command.BaseCommand import BaseCommand
 from gibson.core.Memory import Memory
 
@@ -57,7 +56,7 @@ class Help(BaseCommand):
                 "memory": None,
             },
             "forget": {
-                "description": f"delete entities from memory",
+                "description": "delete entities from memory",
                 "subcommands": ["all", "last", "stored"],
                 "memory": "based on user selection",
             },
@@ -72,6 +71,11 @@ class Help(BaseCommand):
                 "subcommands": ["entities", "projects"],
                 "memory": None,
             },
+            "mcp": {
+                "description": "allows tools like Cursor to interact with your gibson project",
+                "subcommands": ["run"],
+                "memory": None,
+            },
             "merge": {
                 "description": "merge last memory (recent changes) into stored project memory",
                 "subcommands": None,

{gibson_cli-0.7.7 → gibson_cli-0.8.0}/gibson/command/code/Entity.py

@@ -186,10 +186,10 @@ class Entity(BaseCommand):
 
     def __render_workspace(
         self,
-        original_entity: StructureEntity | None,
+        original_entity: StructureEntity,
         entity: StructureEntity,
         model_name: str,
-        original_model_code: str | None,
+        original_model_code: str,
         model_code: str,
     ):
         self.configuration.platform.cmd_clear()

{gibson_cli-0.7.7 → gibson_cli-0.8.0}/gibson/command/list/Projects.py

@@ -13,7 +13,7 @@ class Projects(BaseCommand):
         self.configuration.require_login()
 
         with DisappearingSpinner():
-            projects = ProjectApi(self.configuration).all_projects()
+            projects = ProjectApi(self.configuration).list()
 
         if len(projects) == 0:
             self.conversation.type(

gibson_cli-0.8.0/gibson/command/mcp/McpServer.py

@@ -0,0 +1,25 @@
+import signal
+import sys
+
+import gibson.core.Colors as Colors
+from gibson.command.BaseCommand import BaseCommand
+from gibson.services.mcp.server import mcp
+
+
+class McpServer(BaseCommand):
+    def execute(self):
+        if len(sys.argv) == 3 and sys.argv[2] == "run":
+            # Setup signal handlers to exit the server
+            signal.signal(signal.SIGTERM, lambda signo, frame: sys.exit(0))
+            signal.signal(signal.SIGINT, lambda signo, frame: sys.exit(0))
+            mcp.run()
+        else:
+            self.usage()
+
+    def usage(self):
+        self.configuration.display_project()
+        self.conversation.type(
+            f"usage: {Colors.command(self.configuration.command, 'mcp', args='run', hint='run the mcp server')}\n"
+        )
+        self.conversation.newline()
+        exit(1)

{gibson_cli-0.7.7 → gibson_cli-0.8.0}/gibson/core/CommandRouter.py

@@ -10,6 +10,7 @@ from gibson.command.Forget import Forget
 from gibson.command.Help import Help
 from gibson.command.importer.Import import Import
 from gibson.command.list.List import List
+from gibson.command.mcp.McpServer import McpServer
 from gibson.command.Merge import Merge
 from gibson.command.Modify import Modify
 from gibson.command.new.New import New
@@ -58,6 +59,8 @@ class CommandRouter:
             command = Import(self.configuration)
         elif sys.argv[1] == "list":
             command = List(self.configuration)
+        elif sys.argv[1] == "mcp":
+            command = McpServer(self.configuration)
         elif sys.argv[1] == "merge":
             command = Merge(self.configuration)
         elif sys.argv[1] == "modify":

{gibson_cli-0.7.7 → gibson_cli-0.8.0}/gibson/core/Completions.py

@@ -8,7 +8,7 @@ class Completions:
         self.file_name = "bash_completion"
 
     def install(self):
-        completions_location = f"$HOME/{self.gibson_config}/{self.file_name}"
+        completions_location = f"{self.user_home}/{self.gibson_config}/{self.file_name}"
         installation = f"""\n[ -s "{completions_location}" ] && \\. "{completions_location}" # Load gibson auto completion\n"""
 
         for file in [f"{self.user_home}/.bashrc", f"{self.user_home}/.zshrc"]:
@@ -21,7 +21,7 @@ class Completions:
 
     def write(self):
         try:
-            file = os.path.dirname(__file__) + f"/../data/bash-completion.tmpl"
+            file = os.path.dirname(__file__) + "/../data/bash-completion.tmpl"
             with open(file, "r") as f:
                 contents = f.read()
         except FileNotFoundError:

{gibson_cli-0.7.7 → gibson_cli-0.8.0}/gibson/core/Configuration.py

@@ -235,6 +235,10 @@ class Configuration:
         self.require_project()
         return self.settings[self.project.name]
 
+    def get_project_id(self):
+        self.require_project()
+        return self.project.id
+
     def get_refresh_token(self):
         try:
             with open(f"{self.paths.auth}/{self.API_ENV}", "r") as f:
@@ -329,6 +333,16 @@ class Configuration:
 
         return self
 
+    def require_project_id(self) -> str:
+        project_id = self.get_project_id()
+        if not project_id:
+            self.conversation.type(
+                "A valid project ID is required to perform this action. Please ensure the project ID is set in your configuration.\n"
+            )
+            exit(1)
+
+        return project_id
+
     def require_project_key_or_id(self):
         if self.project.id:
             return self

{gibson_cli-0.7.7 → gibson_cli-0.8.0}/gibson/core/Conversation.py

@@ -105,7 +105,7 @@ class Conversation:
 
     def message_customize_settings(self):
         self.type(
-            f"You can edit the configuration file directly or ask me to do it for you.\n"
+            "You can edit the configuration file directly or ask me to do it for you.\n"
         )
         self.type(
             "I will not be able to do much until you modify api::key and "
@@ -220,7 +220,7 @@ class Conversation:
 
     def project_api_key_not_set(self, configuration):
         self.type(
-            f"\nYou have not set the API key for your project. Please set the API key by executing:\n"
+            "\nYou have not set the API key for your project. Please set the API key by executing:\n"
         )
         self.newline()
         self.type(

gibson_cli-0.8.0/gibson/services/mcp/server.py

@@ -0,0 +1,87 @@
+from typing import Dict, List
+
+from mcp.server.fastmcp import FastMCP
+
+from gibson.api.ProjectApi import ProjectApi
+from gibson.core.Configuration import Configuration
+
+mcp = FastMCP("GibsonAI")
+
+project_api = ProjectApi(Configuration())
+
+# Note: Resources are not yet supported by Cursor, everything must be implemented as a tool
+# See https://docs.cursor.com/context/model-context-protocol#limitations
+
+
+@mcp.tool()
+def get_projects() -> List[Dict]:
+    """Get all GibsonAI projects"""
+    return project_api.list()
+
+
+@mcp.tool()
+def create_project() -> Dict:
+    """Create a new GibsonAI project"""
+    return project_api.create()
+
+
+@mcp.tool()
+def get_project_details(uuid: str) -> Dict:
+    """Get a GibsonAI project's details"""
+    return project_api.lookup(uuid=uuid)
+
+
+@mcp.tool()
+def get_project_hosted_api_details(uuid: str) -> str:
+    """
+    Get a GibsonAI project's hosted API details
+    This includes necessary context for an LLM to understand and generate API calls related to fetching or modifying the project's data
+    """
+    return project_api.mcp(uuid=uuid)
+
+
+@mcp.tool()
+def update_project(uuid: str, project_name: str) -> Dict:
+    """
+    Update a GibsonAI project's details
+    This currently only updates the project's name
+    Returns the updated project details
+    """
+    return project_api.update(uuid=uuid, name=project_name)
+
+
+@mcp.tool()
+def submit_data_modeling_request(uuid: str, data_modeling_request: str) -> Dict:
+    """
+    Submit a data modeling request for a GibsonAI project
+    This tool fully handles all data modeling, you should provide the user's request as-is
+    Returns the response from the LLM
+    """
+    return project_api.submit_message(uuid=uuid, message=data_modeling_request)
+
+
+@mcp.tool()
+def deploy_project(uuid: str) -> None:
+    """
+    Deploy a GibsonAI project's hosted databases
+    This deploys both the development and production databases simultaneously and automatically handles the migrations
+    """
+    project_api.deploy(uuid=uuid)
+
+
+@mcp.tool()
+def get_project_schema(uuid: str) -> str:
+    """
+    Get the schema for a GibsonAI project
+    This includes any changes made to the schema since the last deployment
+    """
+    return project_api.schema(uuid=uuid)
+
+
+@mcp.tool()
+def get_deployed_schema(uuid: str) -> str:
+    """
+    Get the deployed schema for a GibsonAI project
+    This is the schema that is currently live on the project's hosted databases
+    """
+    return project_api.database_schema(uuid=uuid)