mcp-server-appwrite 0.1.4__py3-none-any.whl → 0.2.1__py3-none-any.whl

mcp_server_appwrite/server.py

@@ -1,5 +1,4 @@
 from __future__ import annotations
-from typing import List
 import asyncio
 import os
 import argparse
@@ -18,6 +17,7 @@ from appwrite.services.functions import Functions
 from appwrite.services.locale import Locale
 from appwrite.services.avatars import Avatars
 from appwrite.services.messaging import Messaging
+from appwrite.services.sites import Sites
 from appwrite.exception import AppwriteException
 from .tool_manager import ToolManager
 from .service import Service
@@ -32,6 +32,7 @@ def parse_args():
     parser.add_argument('--messaging', action='store_true', help='Enable Messaging service')
     parser.add_argument('--locale', action='store_true', help='Enable Locale service')
     parser.add_argument('--avatars', action='store_true', help='Enable Avatars service')
+    parser.add_argument('--sites', action='store_true', help='Enable Sites service')
     parser.add_argument('--all', action='store_true', help='Enable all services')
     return parser.parse_args()
 
@@ -51,6 +52,7 @@ client = Client()
 client.set_endpoint(endpoint)
 client.set_project(project_id)
 client.set_key(api_key)
+client.add_header('x-sdk-name', 'mcp')
 
 # Initialize tools manager
 tools_manager = ToolManager()
@@ -60,6 +62,7 @@ def register_services(args):
     if args.all:
         args.databases = args.users = args.teams = args.storage = True
         args.functions = args.messaging = args.locale = args.avatars = True
+        args.sites = True
 
     # Register services based on CLI arguments
     if args.databases:
@@ -78,6 +81,8 @@ def register_services(args):
         tools_manager.register_service(Service(Locale(client), "locale"))
     if args.avatars:
         tools_manager.register_service(Service(Avatars(client), "avatars"))
+    if args.sites:
+        tools_manager.register_service(Service(Sites(client), "sites"))
 
     # If no services were specified, enable databases by default
     if not any([args.databases, args.users, args.teams, args.storage,
@@ -125,7 +130,7 @@ async def _run():
             write_stream,
             InitializationOptions(
                 server_name="appwrite",
-                server_version="0.1.4",
+                server_version="0.2.0",
                 capabilities=server.get_capabilities(
                     notification_options=NotificationOptions(),
                     experimental_capabilities={},

{mcp_server_appwrite-0.1.4.dist-info → mcp_server_appwrite-0.2.1.dist-info}/METADATA

@@ -1,21 +1,17 @@
 Metadata-Version: 2.4
 Name: mcp-server-appwrite
-Version: 0.1.4
+Version: 0.2.1
 Summary: MCP (Model Context Protocol) server for Appwrite
 License-File: LICENSE
 Requires-Python: >=3.12
-Requires-Dist: appwrite>=9.0.3
+Requires-Dist: appwrite>=11.1.0
 Requires-Dist: docstring-parser>=0.16
 Requires-Dist: mcp[cli]>=1.3.0
 Description-Content-Type: text/markdown
 
 # Appwrite MCP server
 
-<!-- Cover image will go here once available -->
-
-<a href="https://glama.ai/mcp/servers/xkj2px7r0v">
-  <img width="380" height="200" src="https://glama.ai/mcp/servers/xkj2px7r0v/badge" alt="Appwrite MCP server" />
-</a>
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/install-mcp?name=appwrite&config=eyJjb21tYW5kIjoidXZ4IG1jcC1zZXJ2ZXItYXBwd3JpdGUgLS11c2VycyIsImVudiI6eyJBUFBXUklURV9BUElfS0VZIjoiPHlvdXItYXBpLWtleT4iLCJBUFBXUklURV9QUk9KRUNUX0lEIjoiPHlvdXItcHJvamVjdC1pZD4iLCJBUFBXUklURV9FTkRQT0lOVCI6Imh0dHBzOi8vPFJFR0lPTj4uY2xvdWQuYXBwd3JpdGUuaW8vdjEifX0%3D)
 
 ## Overview
 
@@ -28,6 +24,7 @@ A Model Context Protocol server for interacting with Appwrite's API. This server
   - [Claude Desktop](#usage-with-claude-desktop)
   - [Cursor](#usage-with-cursor)
   - [Windsurf Editor](#usage-with-windsurf-editor)
+  - [VS Code](#usage-with-vs-code)
 - [Local Development](#local-development)
 - [Debugging](#debugging)
 
@@ -40,7 +37,7 @@ Create a `.env` file in your working directory and add the following:
 ```env
 APPWRITE_PROJECT_ID=your-project-id
 APPWRITE_API_KEY=your-api-key
-APPWRITE_ENDPOINT=https://cloud.appwrite.io/v1
+APPWRITE_ENDPOINT=https://<REGION>.cloud.appwrite.io/v1
 ```
 
 Then, open your terminal and run the following command
@@ -108,6 +105,7 @@ Both the `uv` and `pip` setup processes require certain arguments to enable MCP
 | `--messaging` | Enables the Messaging API |
 | `--locale` | Enables the Locale API |
 | `--avatars` | Enables the Avatars API |
+| `--sites` | Enables the Sites API |
 | `--all` | Enables all Appwrite APIs |
 
 ## Usage with Claude Desktop
@@ -123,9 +121,9 @@ In the Claude Desktop app, open the app's **Settings** page (press `CTRL + ,` on
         "mcp-server-appwrite"
       ],
       "env": {
-        "APPWRITE_PROJECT_ID": "your-project-id",
-        "APPWRITE_API_KEY": "your-api-key",
-        "APPWRITE_ENDPOINT": "https://cloud.appwrite.io/v1" // Optional
+        "APPWRITE_PROJECT_ID": "<YOUR_PROJECT_ID>",
+        "APPWRITE_API_KEY": "<YOUR_API_KEY>",
+        "APPWRITE_ENDPOINT": "https://<REGION>.cloud.appwrite.io/v1" // Optional
       }
     }
   }
@@ -170,9 +168,9 @@ Head to Windsurf `Settings > Cascade > Model Context Protocol (MCP) Servers` and
         "mcp-server-appwrite"
       ],
       "env": {
-        "APPWRITE_PROJECT_ID": "your-project-id",
-        "APPWRITE_API_KEY": "your-api-key",
-        "APPWRITE_ENDPOINT": "https://cloud.appwrite.io/v1" // Optional
+        "APPWRITE_PROJECT_ID": "<YOUR_PROJECT_ID>",
+        "APPWRITE_API_KEY": "<YOUR_API_KEY>",
+        "APPWRITE_ENDPOINT": "https://<REGION>.cloud.appwrite.io/v1" // Optional
       }
     }
   }
@@ -181,6 +179,36 @@ Head to Windsurf `Settings > Cascade > Model Context Protocol (MCP) Servers` and
 
 ![Windsurf Settings](./images/windsurf-integration.png)
 
+## Usage with [VS Code](https://code.visualstudio.com/)
+
+### Configuration
+
+1. **Update the MCP configuration file**: Open the Command Palette (`Ctrl+Shift+P` or `Cmd+Shift+P`) and run `MCP: Open User Configuration`. It should open the `mcp.json` file in your user settings.
+
+2. **Add the Appwrite MCP server configuration**: Add the following to the `mcp.json` file:
+
+```json
+{
+  "servers": {
+    "appwrite": {
+      "command": "uvx",
+      "args": ["mcp-server-appwrite", "--users"],
+      "env": {
+        "APPWRITE_PROJECT_ID": "<YOUR_PROJECT_ID>",
+        "APPWRITE_API_KEY": "<YOUR_API_KEY>",
+        "APPWRITE_ENDPOINT": "https://<REGION>.cloud.appwrite.io/v1"
+      }
+    }
+  }
+}
+```
+
+3. **Start the MCP server**: Open the Command Palette (`Ctrl+Shift+P` or `Cmd+Shift+P`) and run `MCP: List Servers`. In the dropdown, select `appwrite` and click on the **Start Server** button.
+
+4. **Use in Copilot Chat**: Open Copilot Chat and switch to **Agent Mode** to access the Appwrite tools.
+
+![VS Code Settings](./images/vs-code-integration.png)
+
 ## Local Development
 
 ### Clone the repository

{mcp_server_appwrite-0.1.4.dist-info → mcp_server_appwrite-0.2.1.dist-info}/RECORD

@@ -1,10 +1,10 @@
 mcp_server_appwrite/__init__.py,sha256=Od9oaUg_ckgJ4jIGa2HijocyauWDPjIC7cBRiV0P4s8,214
 mcp_server_appwrite/__main__.py,sha256=bdaX6xMmFugzSR2QMdXJqanRx_Jh25jACJDqjE9cKEc,75
-mcp_server_appwrite/server.py,sha256=JxNLY1O5lMUXUkBd2_kvN5mrh6dWsRPzX1VHi-XwCFs,5498
+mcp_server_appwrite/server.py,sha256=KxLXrqIHllcRt_bF6QQ5FJIcDNIuc-XGaGk2qbK6BPU,5757
 mcp_server_appwrite/service.py,sha256=H_Qr8bYFyXuJVwsPsWFi1xx12-aPM75yblKj11L4V2c,4640
 mcp_server_appwrite/tool_manager.py,sha256=AfRjLyMpplYjF2VJna7frXDiDUZKRN8WQu9R8j3dxPc,718
-mcp_server_appwrite-0.1.4.dist-info/METADATA,sha256=Kxq2jAAuvpUz1P1rBRNuauSf3Ipg0TIJx01NFt2JMpY,6565
-mcp_server_appwrite-0.1.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-mcp_server_appwrite-0.1.4.dist-info/entry_points.txt,sha256=-FBKUOp-Qmo9FldmiT3JUyF7djSeo8lLhxljOosuHkQ,74
-mcp_server_appwrite-0.1.4.dist-info/licenses/LICENSE,sha256=PXzk1HbuQMAkLdHzwnBLTBIHFmgDZM0Ez2lw2gX2UQs,1096
-mcp_server_appwrite-0.1.4.dist-info/RECORD,,
+mcp_server_appwrite-0.2.1.dist-info/METADATA,sha256=fGnV0JyX_weKQC3MS2k8y7H0HJAELt44smcboNYmX4g,7891
+mcp_server_appwrite-0.2.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+mcp_server_appwrite-0.2.1.dist-info/entry_points.txt,sha256=-FBKUOp-Qmo9FldmiT3JUyF7djSeo8lLhxljOosuHkQ,74
+mcp_server_appwrite-0.2.1.dist-info/licenses/LICENSE,sha256=PXzk1HbuQMAkLdHzwnBLTBIHFmgDZM0Ez2lw2gX2UQs,1096
+mcp_server_appwrite-0.2.1.dist-info/RECORD,,