mcp-server-appwrite 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -39,25 +39,15 @@ client.set_key(api_key)
39
39
  # Initialize tools manager and register services
40
40
  tools_manager = ToolManager()
41
41
  tools_manager.register_service(Service(Users(client), "users"))
42
- tools_manager.register_service(Service(Teams(client), "teams"))
42
+ # tools_manager.register_service(Service(Teams(client), "teams"))
43
43
  tools_manager.register_service(Service(Databases(client), "databases"))
44
- tools_manager.register_service(Service(Storage(client), "storage"))
45
- tools_manager.register_service(Service(Functions(client), "functions"))
46
- tools_manager.register_service(Service(Messaging(client), "messaging"))
47
- tools_manager.register_service(Service(Locale(client), "locale"))
48
- tools_manager.register_service(Service(Avatars(client), "avatars"))
44
+ # tools_manager.register_service(Service(Storage(client), "storage"))
45
+ # tools_manager.register_service(Service(Functions(client), "functions"))
46
+ # tools_manager.register_service(Service(Messaging(client), "messaging"))
49
47
 
50
48
  async def serve() -> Server:
51
49
  server = Server("Appwrite MCP Server")
52
50
 
53
- # @server.list_resources()
54
- # async def handle_list_resources() -> list[types.Resource]:
55
- # return tools_manager.get_all_resources()
56
-
57
- # @server.read_resource()
58
- # async def handle_read_resource(resource_id: str) -> str:
59
- # return tools_manager.get_resource(resource_id)
60
-
61
51
  @server.list_tools()
62
52
  async def handle_list_tools() -> list[types.Tool]:
63
53
  return tools_manager.get_all_tools()
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: mcp-server-appwrite
3
- Version: 0.1.0
3
+ Version: 0.1.2
4
4
  Summary: MCP (Model Context Protocol) server for Appwrite
5
5
  License-File: LICENSE
6
6
  Requires-Python: >=3.12
@@ -18,64 +18,50 @@ Currently the server supports the following tools:
18
18
 
19
19
  - [x] Databases
20
20
  - [x] Users
21
- - [x] Teams
22
- - [x] Messaging
23
- - [x] Locale
24
- - [x] Avatars
25
- - [x] Storage (Beta)
26
- - [x] Functions (Beta)
27
21
 
28
- > Please note that the Storage and Functions tools are currently in beta and methods like createFile and createDeployment are not yet supported.
22
+ > 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.
29
23
 
30
- ## Local Development
24
+ ## Configuration
31
25
 
32
- Clone the repository
26
+ Create a `.env` file in the directory you're runing the server from:
33
27
 
34
- ```bash
35
- git clone https://github.com/appwrite/mcp.git
28
+ ```env
29
+ APPWRITE_API_KEY=your-api-key
30
+ APPWRITE_PROJECT_ID=your-project-id
31
+ APPWRITE_ENDPOINT=your-endpoint # Optional, defaults to https://cloud.appwrite.io/v1
36
32
  ```
33
+ > Note: Ensure that your API Key has the necessary scopes to access the resources you want to use.
37
34
 
38
- Install `uv`
39
-
40
- ```bash
41
- curl -LsSf https://astral.sh/uv/install.sh | sh
42
- ```
35
+ ## Installation
43
36
 
44
- Create virtual environment
37
+ ### Using uv (recommended)
38
+ When using [`uv`](https://docs.astral.sh/uv/) no specific installation is needed. We will
39
+ use [`uvx`](https://docs.astral.sh/uv/guides/tools/) to directly run *mcp-server-sentry*.
45
40
 
46
41
  ```bash
47
- uv venv
48
- source .venv/bin/activate
42
+ uvx run mcp-server-appwrite
49
43
  ```
50
44
 
51
- ## Configuration
45
+ ### Using pip
52
46
 
53
- Create a `.env` file in the root directory based on `.env.example`:
54
-
55
- ```env
56
- APPWRITE_API_KEY=your-api-key
57
- APPWRITE_PROJECT_ID=your-project-id
58
- APPWRITE_ENDPOINT=your-endpoint # Optional, defaults to https://cloud.appwrite.io/v1
47
+ ```bash
48
+ pip install mcp-server-appwrite
59
49
  ```
60
-
61
- Run the server
50
+ Then run the server using
62
51
 
63
52
  ```bash
64
- uv run -v --directory ./ mcp-server-appwrite
53
+ python -m mcp_server_appwrite
65
54
  ```
66
55
 
67
- ### Usage with Claude Desktop
56
+ ## Usage with Claude Desktop
68
57
 
69
58
  Add this to your `claude_desktop_config.json`:
70
59
 
71
60
  ```json
72
61
  "mcpServers": {
73
62
  "appwrite": {
74
- "command": "uv",
63
+ "command": "uvx",
75
64
  "args": [
76
- "run",
77
- "--directory",
78
- "<path-to-repository>",
79
65
  "mcp-server-appwrite"
80
66
  ],
81
67
  "env": {
@@ -86,23 +72,19 @@ Add this to your `claude_desktop_config.json`:
86
72
  }
87
73
  }
88
74
  ```
89
-
90
75
  Upon successful configuration, you should be able to see the server in the list of available servers in Claude Desktop.
91
76
 
92
77
  ![Claude Desktop Config](images/claude-desktop-integration.png)
93
78
 
94
- ### Usage with [Zed](https://github.com/zed-industries/zed)
79
+ ## Usage with [Zed](https://github.com/zed-industries/zed)
95
80
 
96
81
  Add to your Zed settings.json:
97
82
 
98
83
  ```json
99
84
  "context_servers": {
100
85
  "appwrite": {
101
- "command": "uv",
86
+ "command": "uvx",
102
87
  "args": [
103
- "run",
104
- "--directory",
105
- "<path-to-repository>",
106
88
  "mcp-server-appwrite"
107
89
  ],
108
90
  "env": {
@@ -114,16 +96,43 @@ Add to your Zed settings.json:
114
96
  }
115
97
  ```
116
98
 
117
- ### Usage with [Cursor](https://www.cursor.com/)
99
+ ## Usage with [Cursor](https://www.cursor.com/)
118
100
 
119
101
  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.
120
102
 
121
103
  ```bash
122
- APPWRITE_PROJECT_ID=your-project-id APPWRITE_API_KEY=your-api-key uv run --directory <path_to_repository> mcp-server-appwrite
104
+ APPWRITE_PROJECT_ID=your-project-id APPWRITE_API_KEY=your-api-key uvx mcp-server-appwrite
123
105
  ```
124
106
 
125
107
  ![Cursor Settings](./images/cursor-integration.png)
126
108
 
109
+ ## Local Development
110
+
111
+ Clone the repository
112
+
113
+ ```bash
114
+ git clone https://github.com/appwrite/mcp.git
115
+ ```
116
+
117
+ Install `uv`
118
+
119
+ ```bash
120
+ curl -LsSf https://astral.sh/uv/install.sh | sh
121
+ ```
122
+
123
+ Create virtual environment
124
+
125
+ ```bash
126
+ uv venv
127
+ source .venv/bin/activate
128
+ ```
129
+
130
+ Run the server
131
+
132
+ ```bash
133
+ uv run -v --directory ./ mcp-server-appwrite
134
+ ```
135
+
127
136
  ## Debugging
128
137
 
129
138
  You can use the MCP inspector to debug the server.
@@ -149,7 +158,4 @@ This MCP server is licensed under the MIT License. This means you are free to us
149
158
  - https://github.com/punkpeye/awesome-mcp-servers
150
159
  - https://portkey.ai/mcp-servers
151
160
  - https://www.claudemcp.com/servers
152
- - Add support for SSE server
153
- - Release to PIP
154
- - ✅ Add support for env vars
155
- - Add suppport for resources
161
+ - Add support for SSE server
@@ -1,10 +1,10 @@
1
1
  mcp_server_appwrite/__init__.py,sha256=Od9oaUg_ckgJ4jIGa2HijocyauWDPjIC7cBRiV0P4s8,214
2
2
  mcp_server_appwrite/__main__.py,sha256=bdaX6xMmFugzSR2QMdXJqanRx_Jh25jACJDqjE9cKEc,75
3
- mcp_server_appwrite/server.py,sha256=bR_1QL9hmFeNS4aNOZbgEHkZCfQI7iBOvAnL1BYRkoU,3960
3
+ mcp_server_appwrite/server.py,sha256=a6y26aJXQ-NbaUwq3Yud2XT3xlxD6QTBgALDAkz2Cfo,3527
4
4
  mcp_server_appwrite/service.py,sha256=WwKoh9o7W7ZOmhY0yg6k4R2cghQRe-yMTNbFtB6TFT8,2895
5
5
  mcp_server_appwrite/tool_manager.py,sha256=AfRjLyMpplYjF2VJna7frXDiDUZKRN8WQu9R8j3dxPc,718
6
- mcp_server_appwrite-0.1.0.dist-info/METADATA,sha256=f6USs_RH5GLiD_tp4IC5Q8bxbt6dOzwrBbMxAxT1J4s,3786
7
- mcp_server_appwrite-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
8
- mcp_server_appwrite-0.1.0.dist-info/entry_points.txt,sha256=-FBKUOp-Qmo9FldmiT3JUyF7djSeo8lLhxljOosuHkQ,74
9
- mcp_server_appwrite-0.1.0.dist-info/licenses/LICENSE,sha256=PXzk1HbuQMAkLdHzwnBLTBIHFmgDZM0Ez2lw2gX2UQs,1096
10
- mcp_server_appwrite-0.1.0.dist-info/RECORD,,
6
+ mcp_server_appwrite-0.1.2.dist-info/METADATA,sha256=VA_JFBLw_fdqFghwgqX3YvHmTWksvQlV4H-ycsFcLtA,3964
7
+ mcp_server_appwrite-0.1.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
8
+ mcp_server_appwrite-0.1.2.dist-info/entry_points.txt,sha256=-FBKUOp-Qmo9FldmiT3JUyF7djSeo8lLhxljOosuHkQ,74
9
+ mcp_server_appwrite-0.1.2.dist-info/licenses/LICENSE,sha256=PXzk1HbuQMAkLdHzwnBLTBIHFmgDZM0Ez2lw2gX2UQs,1096
10
+ mcp_server_appwrite-0.1.2.dist-info/RECORD,,