mcp-server-appwrite 0.1.1__py3-none-any.whl → 0.1.3__py3-none-any.whl

mcp_server_appwrite/server.py

@@ -1,5 +1,8 @@
+from __future__ import annotations
+from typing import List
 import asyncio
 import os
+import argparse
 import mcp.server.stdio
 import mcp.types as types
 from mcp.server import NotificationOptions, Server
@@ -19,6 +22,19 @@ from appwrite.exception import AppwriteException
 from .tool_manager import ToolManager
 from .service import Service
 
+def parse_args():
+    parser = argparse.ArgumentParser(description='Appwrite MCP Server')
+    parser.add_argument('--databases', action='store_true', help='Enable Databases service')
+    parser.add_argument('--users', action='store_true', help='Enable Users service')
+    parser.add_argument('--teams', action='store_true', help='Enable Teams service')
+    parser.add_argument('--storage', action='store_true', help='Enable Storage service')
+    parser.add_argument('--functions', action='store_true', help='Enable Functions service')
+    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('--all', action='store_true', help='Enable all services')
+    return parser.parse_args()
+
 # Load environment variables from .env file
 load_dotenv()
 
@@ -36,28 +52,41 @@ client.set_endpoint(endpoint)
 client.set_project(project_id)
 client.set_key(api_key)
 
-# Initialize tools manager and register services
+# Initialize tools manager
 tools_manager = ToolManager()
-tools_manager.register_service(Service(Users(client), "users"))
-tools_manager.register_service(Service(Teams(client), "teams"))
-tools_manager.register_service(Service(Databases(client), "databases"))
-tools_manager.register_service(Service(Storage(client), "storage"))
-tools_manager.register_service(Service(Functions(client), "functions"))
-tools_manager.register_service(Service(Messaging(client), "messaging"))
-tools_manager.register_service(Service(Locale(client), "locale"))
-tools_manager.register_service(Service(Avatars(client), "avatars"))
+
+def register_services(args):
+    # If --all is specified, enable all services
+    if args.all:
+        args.databases = args.users = args.teams = args.storage = True
+        args.functions = args.messaging = args.locale = args.avatars = True
+
+    # Register services based on CLI arguments
+    if args.databases:
+        tools_manager.register_service(Service(Databases(client), "databases"))
+    if args.users:
+        tools_manager.register_service(Service(Users(client), "users"))
+    if args.teams:
+        tools_manager.register_service(Service(Teams(client), "teams"))
+    if args.storage:
+        tools_manager.register_service(Service(Storage(client), "storage"))
+    if args.functions:
+        tools_manager.register_service(Service(Functions(client), "functions"))
+    if args.messaging:
+        tools_manager.register_service(Service(Messaging(client), "messaging"))
+    if args.locale:
+        tools_manager.register_service(Service(Locale(client), "locale"))
+    if args.avatars:
+        tools_manager.register_service(Service(Avatars(client), "avatars"))
+
+    # If no services were specified, enable databases by default
+    if not any([args.databases, args.users, args.teams, args.storage,
+                args.functions, args.messaging, args.locale, args.avatars]):
+        tools_manager.register_service(Service(Databases(client), "databases"))
 
 async def serve() -> Server:
     server = Server("Appwrite MCP Server")
     
-    # @server.list_resources()
-    # async def handle_list_resources() -> list[types.Resource]:
-    #     return tools_manager.get_all_resources()
-    
-    # @server.read_resource()
-    # async def handle_read_resource(resource_id: str) -> str:
-    #     return tools_manager.get_resource(resource_id)
-    
     @server.list_tools()
     async def handle_list_tools() -> list[types.Tool]:
         return tools_manager.get_all_tools()
@@ -86,6 +115,9 @@ async def serve() -> Server:
     return server
 
 async def _run():
+    args = parse_args()
+    register_services(args)
+    
     async with mcp.server.stdio.stdio_server() as (read_stream, write_stream):
         server = await serve()
         await server.run(
@@ -93,7 +125,7 @@ async def _run():
             write_stream,
             InitializationOptions(
                 server_name="appwrite",
-                server_version="0.1.0",
+                server_version="0.1.3",
                 capabilities=server.get_capabilities(
                     notification_options=NotificationOptions(),
                     experimental_capabilities={},

{mcp_server_appwrite-0.1.1.dist-info → mcp_server_appwrite-0.1.3.dist-info}/METADATA

@@ -1,47 +1,54 @@
 Metadata-Version: 2.4
 Name: mcp-server-appwrite
-Version: 0.1.1
+Version: 0.1.3
 Summary: MCP (Model Context Protocol) server for Appwrite
 License-File: LICENSE
 Requires-Python: >=3.12
-Requires-Dist: appwrite>=7.1.0
+Requires-Dist: appwrite>=9.0.2
 Requires-Dist: mcp[cli]>=1.3.0
 Description-Content-Type: text/markdown
 
 # Appwrite MCP server
 
+<!-- Cover image will go here once available -->
+
 ## Overview
 
 A Model Context Protocol server for interacting with Appwrite's API. This server provides tools to manage databases, users, functions, teams, and more within your Appwrite project.
 
-Currently the server supports the following tools:
+## Quick Links
+- [Configuration](#configuration)
+- [Installation](#installation)
+- IDE Integration:
+  - [Claude Desktop](#usage-with-claude-desktop)
+  - [Zed](#usage-with-zed)
+  - [Cursor](#usage-with-cursor)
+- [Local Development](#local-development)
+- [Debugging](#debugging)
+
+Currently, the server supports the following tools:
 
 - [x] Databases
 - [x] Users
-- [x] Teams
-- [x] Messaging
-- [x] Locale
-- [x] Avatars
-- [x] Storage (Beta)
-- [x] Functions (Beta)
 
-> Please note that the Storage and Functions tools are currently in beta and methods like createFile and createDeployment are not yet supported.
+> Please note that adding a lot of tools exceeds the context window of the LLM. As a result, we will make available a curated list of tools that are most commonly used.
 
 ## Configuration
 
-Create a `.env` file in the directory you're runing the server from:
+Create a `.env` file in the directory you're running the server from:
 
 ```env
 APPWRITE_API_KEY=your-api-key
 APPWRITE_PROJECT_ID=your-project-id
 APPWRITE_ENDPOINT=your-endpoint  # Optional, defaults to https://cloud.appwrite.io/v1
 ```
+> Note: Ensure that your API Key has the necessary scopes to access the resources you want to use.
 
 ## Installation
 
 ### Using uv (recommended)
 When using [`uv`](https://docs.astral.sh/uv/) no specific installation is needed. We will
-use [`uvx`](https://docs.astral.sh/uv/guides/tools/) to directly run *mcp-server-sentry*.
+use [`uvx`](https://docs.astral.sh/uv/guides/tools/) to directly run *mcp-server-appwrite*.
 
 ```bash
 uvx run mcp-server-appwrite
@@ -58,33 +65,6 @@ Then run the server using
 python -m mcp_server_appwrite
 ```
 
-## Local Development
-
-Clone the repository
-
-```bash
-git clone https://github.com/appwrite/mcp.git
-```
-
-Install `uv`
-
-```bash
-curl -LsSf https://astral.sh/uv/install.sh | sh
-```
-
-Create virtual environment
-
-```bash
-uv venv
-source .venv/bin/activate
-```
-
-Run the server
-
-```bash
-uv run -v --directory ./ mcp-server-appwrite
-```
-
 ## Usage with Claude Desktop
 
 Add this to your `claude_desktop_config.json`:
@@ -128,7 +108,7 @@ Add to your Zed settings.json:
 }
 ```
 
-### Usage with [Cursor](https://www.cursor.com/)
+## Usage with [Cursor](https://www.cursor.com/)
 
 Head to Cursor `Settings > Features > MCP Servers` and click on **Add New MCP Server**. Choose the type as `Command` and add the command below to the **Command** field.
 
@@ -138,6 +118,33 @@ APPWRITE_PROJECT_ID=your-project-id APPWRITE_API_KEY=your-api-key uvx mcp-server
 
 ![Cursor Settings](./images/cursor-integration.png)
 
+## Local Development
+
+Clone the repository
+
+```bash
+git clone https://github.com/appwrite/mcp.git
+```
+
+Install `uv`
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+Create virtual environment
+
+```bash
+uv venv
+source .venv/bin/activate
+```
+
+Run the server
+
+```bash
+uv run -v --directory ./ mcp-server-appwrite
+```
+
 ## Debugging
 
 You can use the MCP inspector to debug the server. 
@@ -164,4 +171,3 @@ This MCP server is licensed under the MIT License. This means you are free to us
   - https://portkey.ai/mcp-servers
   - https://www.claudemcp.com/servers
 - Add support for SSE server
-- Add suppport for resources

{mcp_server_appwrite-0.1.1.dist-info → mcp_server_appwrite-0.1.3.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=bR_1QL9hmFeNS4aNOZbgEHkZCfQI7iBOvAnL1BYRkoU,3960
+mcp_server_appwrite/server.py,sha256=J_Ze0DiYYmL1wbHi4Z4LK7UTYhVemBij6O_j6zPvMCg,5498
 mcp_server_appwrite/service.py,sha256=WwKoh9o7W7ZOmhY0yg6k4R2cghQRe-yMTNbFtB6TFT8,2895
 mcp_server_appwrite/tool_manager.py,sha256=AfRjLyMpplYjF2VJna7frXDiDUZKRN8WQu9R8j3dxPc,718
-mcp_server_appwrite-0.1.1.dist-info/METADATA,sha256=hGVxdm0fGuwxpdUIbvtfTOzo18UniTzhQcdTdA4mc58,3970
-mcp_server_appwrite-0.1.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-mcp_server_appwrite-0.1.1.dist-info/entry_points.txt,sha256=-FBKUOp-Qmo9FldmiT3JUyF7djSeo8lLhxljOosuHkQ,74
-mcp_server_appwrite-0.1.1.dist-info/licenses/LICENSE,sha256=PXzk1HbuQMAkLdHzwnBLTBIHFmgDZM0Ez2lw2gX2UQs,1096
-mcp_server_appwrite-0.1.1.dist-info/RECORD,,
+mcp_server_appwrite-0.1.3.dist-info/METADATA,sha256=CPQt1rKcgsA_0h-l-rUl6O34HvkU1HZuKqYGVPJfCzc,4297
+mcp_server_appwrite-0.1.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+mcp_server_appwrite-0.1.3.dist-info/entry_points.txt,sha256=-FBKUOp-Qmo9FldmiT3JUyF7djSeo8lLhxljOosuHkQ,74
+mcp_server_appwrite-0.1.3.dist-info/licenses/LICENSE,sha256=PXzk1HbuQMAkLdHzwnBLTBIHFmgDZM0Ez2lw2gX2UQs,1096
+mcp_server_appwrite-0.1.3.dist-info/RECORD,,