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.
- mcp_server_appwrite/server.py +4 -14
- {mcp_server_appwrite-0.1.0.dist-info → mcp_server_appwrite-0.1.2.dist-info}/METADATA +53 -47
- {mcp_server_appwrite-0.1.0.dist-info → mcp_server_appwrite-0.1.2.dist-info}/RECORD +6 -6
- {mcp_server_appwrite-0.1.0.dist-info → mcp_server_appwrite-0.1.2.dist-info}/WHEEL +0 -0
- {mcp_server_appwrite-0.1.0.dist-info → mcp_server_appwrite-0.1.2.dist-info}/entry_points.txt +0 -0
- {mcp_server_appwrite-0.1.0.dist-info → mcp_server_appwrite-0.1.2.dist-info}/licenses/LICENSE +0 -0
mcp_server_appwrite/server.py
CHANGED
@@ -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.
|
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
|
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
|
-
##
|
24
|
+
## Configuration
|
31
25
|
|
32
|
-
|
26
|
+
Create a `.env` file in the directory you're runing the server from:
|
33
27
|
|
34
|
-
```
|
35
|
-
|
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
|
-
|
39
|
-
|
40
|
-
```bash
|
41
|
-
curl -LsSf https://astral.sh/uv/install.sh | sh
|
42
|
-
```
|
35
|
+
## Installation
|
43
36
|
|
44
|
-
|
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
|
-
|
48
|
-
source .venv/bin/activate
|
42
|
+
uvx run mcp-server-appwrite
|
49
43
|
```
|
50
44
|
|
51
|
-
|
45
|
+
### Using pip
|
52
46
|
|
53
|
-
|
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
|
-
|
53
|
+
python -m mcp_server_appwrite
|
65
54
|
```
|
66
55
|
|
67
|
-
|
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": "
|
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
|

|
93
78
|
|
94
|
-
|
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": "
|
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
|
-
|
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
|
104
|
+
APPWRITE_PROJECT_ID=your-project-id APPWRITE_API_KEY=your-api-key uvx mcp-server-appwrite
|
123
105
|
```
|
124
106
|
|
125
107
|

|
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=
|
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.
|
7
|
-
mcp_server_appwrite-0.1.
|
8
|
-
mcp_server_appwrite-0.1.
|
9
|
-
mcp_server_appwrite-0.1.
|
10
|
-
mcp_server_appwrite-0.1.
|
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,,
|
File without changes
|
{mcp_server_appwrite-0.1.0.dist-info → mcp_server_appwrite-0.1.2.dist-info}/entry_points.txt
RENAMED
File without changes
|
{mcp_server_appwrite-0.1.0.dist-info → mcp_server_appwrite-0.1.2.dist-info}/licenses/LICENSE
RENAMED
File without changes
|