geoservercloud-mcp 0.0.1__tar.gz

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.
Files changed (6) hide show
  1. geoservercloud_mcp-0.0.1/LICENSE +22 -0
  2. geoservercloud_mcp-0.0.1/PKG-INFO +194 -0
  3. geoservercloud_mcp-0.0.1/README.md +170 -0
  4. geoservercloud_mcp-0.0.1/geoservercloud_mcp/__init__.py +10 -0
  5. geoservercloud_mcp-0.0.1/geoservercloud_mcp/server.py +1409 -0
  6. geoservercloud_mcp-0.0.1/pyproject.toml +29 -0
geoservercloud_mcp-0.0.1/LICENSE ADDED
@@ -0,0 +1,22 @@
1
+ Copyright (c) 2024, Camptocamp SA
2
+ All rights reserved.
3
+
4
+ Redistribution and use in source and binary forms, with or without
5
+ modification, are permitted provided that the following conditions are met:
6
+
7
+ 1. Redistributions of source code must retain the above copyright notice, this
8
+ list of conditions and the following disclaimer.
9
+ 2. Redistributions in binary form must reproduce the above copyright notice,
10
+ this list of conditions and the following disclaimer in the documentation
11
+ and/or other materials provided with the distribution.
12
+
13
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
14
+ ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
15
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
16
+ DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
17
+ ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
18
+ (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
19
+ LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
20
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
21
+ (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
22
+ SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
geoservercloud_mcp-0.0.1/PKG-INFO ADDED
@@ -0,0 +1,194 @@
1
+ Metadata-Version: 2.4
2
+ Name: geoservercloud-mcp
3
+ Version: 0.0.1
4
+ Summary: MCP (Model Context Protocol) server for GeoServer - enables AI assistants to manage GeoServer workspaces, datastores, layers, and styles through natural language
5
+ License: BSD-2-Clause
6
+ License-File: LICENSE
7
+ Keywords: geoserver,mcp,model-context-protocol,ai,llm,geospatial
8
+ Author: Ronit Jadhav
9
+ Author-email: ronit.jadhav@camptocamp.com
10
+ Requires-Python: >=3.10,<4.0
11
+ Classifier: License :: OSI Approved :: BSD License
12
+ Classifier: Programming Language :: Python :: 3
13
+ Classifier: Programming Language :: Python :: 3.10
14
+ Classifier: Programming Language :: Python :: 3.11
15
+ Classifier: Programming Language :: Python :: 3.12
16
+ Classifier: Programming Language :: Python :: 3.13
17
+ Classifier: Programming Language :: Python :: 3.14
18
+ Requires-Dist: fastmcp (>=2.0.0)
19
+ Requires-Dist: geoservercloud (>=0.8.7)
20
+ Project-URL: Homepage, https://github.com/ronitjadhav/geoservercloud-mcp
21
+ Project-URL: Repository, https://github.com/ronitjadhav/geoservercloud-mcp
22
+ Description-Content-Type: text/markdown
23
+
24
+ # GeoServer MCP Server
25
+
26
+ <!-- mcp-name: io.github.ronitjadhav/geoservercloud-mcp -->
27
+
28
+ A Model Context Protocol (MCP) server that exposes [GeoServer](https://geoserver.org/) REST API functionality for natural language interaction through AI assistants like Claude, VS Code Copilot, and other MCP-compatible clients.
29
+
30
+ ## About
31
+
32
+ This MCP server wraps the [python-geoservercloud](docs/LIBRARY.md) library, exposing 80+ GeoServer operations as MCP tools. This enables AI assistants to manage GeoServer workspaces, datastores, layers, styles, and more through natural language commands.
33
+
34
+ ### Example Interactions
35
+
36
+ Once connected, you can ask your AI assistant things like:
37
+
38
+ - _"List all workspaces in GeoServer"_
39
+ - _"Create a new workspace called 'test_data'"_
40
+ - _"What layers are available in the 'topp' workspace?"_
41
+ - _"Create a PostGIS datastore connection"_
42
+
43
+ ---
44
+
45
+ ## Installation
46
+
47
+ ### From PyPI
48
+
49
+ ```bash
50
+ pip install geoservercloud-mcp
51
+ ```
52
+
53
+ Or use `uvx` to run without installing (requires [uv](https://docs.astral.sh/uv/)):
54
+
55
+ ```bash
56
+ # Install uv first (if not already installed)
57
+ curl -LsSf https://astral.sh/uv/install.sh | sh
58
+
59
+ # Run the MCP server
60
+ uvx geoservercloud-mcp
61
+ ```
62
+
63
+ ### From MCP Registry
64
+
65
+ This server is published to the [MCP Registry](https://registry.modelcontextprotocol.io) as:
66
+
67
+ ```text
68
+ io.github.ronitjadhav/geoservercloud-mcp
69
+ ```
70
+
71
+ ---
72
+
73
+ ## Connecting to AI Clients
74
+
75
+ ### VS Code / Cursor
76
+
77
+ Add to your MCP configuration (`.vscode/mcp.json`):
78
+
79
+ ```json
80
+ {
81
+ "servers": {
82
+ "geoserver": {
83
+ "command": "uvx",
84
+ "args": ["geoservercloud-mcp"],
85
+ "env": {
86
+ "GEOSERVER_URL": "http://localhost:8080/geoserver",
87
+ "GEOSERVER_USER": "admin",
88
+ "GEOSERVER_PASSWORD": "geoserver"
89
+ }
90
+ }
91
+ }
92
+ }
93
+ ```
94
+
95
+ ### Claude Desktop
96
+
97
+ Add to your Claude Desktop config:
98
+
99
+ **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
100
+ **Linux:** `~/.config/Claude/claude_desktop_config.json`
101
+
102
+ ```json
103
+ {
104
+ "mcpServers": {
105
+ "geoserver": {
106
+ "command": "uvx",
107
+ "args": ["geoservercloud-mcp"],
108
+ "env": {
109
+ "GEOSERVER_URL": "http://localhost:8080/geoserver",
110
+ "GEOSERVER_USER": "admin",
111
+ "GEOSERVER_PASSWORD": "geoserver"
112
+ }
113
+ }
114
+ }
115
+ }
116
+ ```
117
+
118
+ Restart Claude Desktop after saving the configuration.
119
+
120
+ ### Claude Code
121
+
122
+ Add the server with the `claude mcp add` command:
123
+
124
+ ```bash
125
+ claude mcp add geoserver \
126
+ --env GEOSERVER_URL=http://localhost:8080/geoserver \
127
+ --env GEOSERVER_USER=admin \
128
+ --env GEOSERVER_PASSWORD=geoserver \
129
+ -- uvx geoservercloud-mcp
130
+ ```
131
+
132
+ This adds it at the default _local_ (per-project) scope. Use `--scope user` to make
133
+ it available in all your projects, or `--scope project` to write it to a shared
134
+ `.mcp.json` committed in the repo. Omit the `--env` flags to configure the connection
135
+ at runtime instead (the AI will ask for the URL and credentials).
136
+
137
+ Manage it with:
138
+
139
+ ```bash
140
+ claude mcp list
141
+ claude mcp get geoserver
142
+ claude mcp remove geoserver
143
+ ```
144
+
145
+ ### Dynamic Configuration (No Hardcoded Credentials)
146
+
147
+ You can omit the `env` section entirely. The AI will ask you for the GeoServer URL, username, and password at runtime:
148
+
149
+ ```json
150
+ {
151
+ "mcpServers": {
152
+ "geoserver": {
153
+ "command": "uvx",
154
+ "args": ["geoservercloud-mcp"]
155
+ }
156
+ }
157
+ }
158
+ ```
159
+
160
+ ---
161
+
162
+ ## Environment Variables
163
+
164
+ | Variable | Default | Description |
165
+ | -------------------- | --------------------------------- | ------------------ |
166
+ | `GEOSERVER_URL` | `http://localhost:8080/geoserver` | GeoServer base URL |
167
+ | `GEOSERVER_USER` | `admin` | GeoServer username |
168
+ | `GEOSERVER_PASSWORD` | `geoserver` | GeoServer password |
169
+
170
+ ---
171
+
172
+ ## Python Library
173
+
174
+ This MCP server is built on the **python-geoservercloud** library. For programmatic access without MCP, see the [library documentation](docs/LIBRARY.md).
175
+
176
+ ```python
177
+ from geoservercloud import GeoServerCloud
178
+
179
+ geoserver = GeoServerCloud(
180
+ url="http://localhost:8080/geoserver",
181
+ user="admin",
182
+ password="geoserver",
183
+ )
184
+ geoserver.create_workspace("my_workspace")
185
+ ```
186
+
187
+ Full documentation: <https://camptocamp.github.io/python-geoservercloud/>
188
+
189
+ ---
190
+
191
+ ## Development
192
+
193
+ For local development, testing, and publishing, see the [Developer Guide](docs/DEVELOPER.md).
194
+
geoservercloud_mcp-0.0.1/README.md ADDED
@@ -0,0 +1,170 @@
1
+ # GeoServer MCP Server
2
+
3
+ <!-- mcp-name: io.github.ronitjadhav/geoservercloud-mcp -->
4
+
5
+ A Model Context Protocol (MCP) server that exposes [GeoServer](https://geoserver.org/) REST API functionality for natural language interaction through AI assistants like Claude, VS Code Copilot, and other MCP-compatible clients.
6
+
7
+ ## About
8
+
9
+ This MCP server wraps the [python-geoservercloud](docs/LIBRARY.md) library, exposing 80+ GeoServer operations as MCP tools. This enables AI assistants to manage GeoServer workspaces, datastores, layers, styles, and more through natural language commands.
10
+
11
+ ### Example Interactions
12
+
13
+ Once connected, you can ask your AI assistant things like:
14
+
15
+ - _"List all workspaces in GeoServer"_
16
+ - _"Create a new workspace called 'test_data'"_
17
+ - _"What layers are available in the 'topp' workspace?"_
18
+ - _"Create a PostGIS datastore connection"_
19
+
20
+ ---
21
+
22
+ ## Installation
23
+
24
+ ### From PyPI
25
+
26
+ ```bash
27
+ pip install geoservercloud-mcp
28
+ ```
29
+
30
+ Or use `uvx` to run without installing (requires [uv](https://docs.astral.sh/uv/)):
31
+
32
+ ```bash
33
+ # Install uv first (if not already installed)
34
+ curl -LsSf https://astral.sh/uv/install.sh | sh
35
+
36
+ # Run the MCP server
37
+ uvx geoservercloud-mcp
38
+ ```
39
+
40
+ ### From MCP Registry
41
+
42
+ This server is published to the [MCP Registry](https://registry.modelcontextprotocol.io) as:
43
+
44
+ ```text
45
+ io.github.ronitjadhav/geoservercloud-mcp
46
+ ```
47
+
48
+ ---
49
+
50
+ ## Connecting to AI Clients
51
+
52
+ ### VS Code / Cursor
53
+
54
+ Add to your MCP configuration (`.vscode/mcp.json`):
55
+
56
+ ```json
57
+ {
58
+ "servers": {
59
+ "geoserver": {
60
+ "command": "uvx",
61
+ "args": ["geoservercloud-mcp"],
62
+ "env": {
63
+ "GEOSERVER_URL": "http://localhost:8080/geoserver",
64
+ "GEOSERVER_USER": "admin",
65
+ "GEOSERVER_PASSWORD": "geoserver"
66
+ }
67
+ }
68
+ }
69
+ }
70
+ ```
71
+
72
+ ### Claude Desktop
73
+
74
+ Add to your Claude Desktop config:
75
+
76
+ **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
77
+ **Linux:** `~/.config/Claude/claude_desktop_config.json`
78
+
79
+ ```json
80
+ {
81
+ "mcpServers": {
82
+ "geoserver": {
83
+ "command": "uvx",
84
+ "args": ["geoservercloud-mcp"],
85
+ "env": {
86
+ "GEOSERVER_URL": "http://localhost:8080/geoserver",
87
+ "GEOSERVER_USER": "admin",
88
+ "GEOSERVER_PASSWORD": "geoserver"
89
+ }
90
+ }
91
+ }
92
+ }
93
+ ```
94
+
95
+ Restart Claude Desktop after saving the configuration.
96
+
97
+ ### Claude Code
98
+
99
+ Add the server with the `claude mcp add` command:
100
+
101
+ ```bash
102
+ claude mcp add geoserver \
103
+ --env GEOSERVER_URL=http://localhost:8080/geoserver \
104
+ --env GEOSERVER_USER=admin \
105
+ --env GEOSERVER_PASSWORD=geoserver \
106
+ -- uvx geoservercloud-mcp
107
+ ```
108
+
109
+ This adds it at the default _local_ (per-project) scope. Use `--scope user` to make
110
+ it available in all your projects, or `--scope project` to write it to a shared
111
+ `.mcp.json` committed in the repo. Omit the `--env` flags to configure the connection
112
+ at runtime instead (the AI will ask for the URL and credentials).
113
+
114
+ Manage it with:
115
+
116
+ ```bash
117
+ claude mcp list
118
+ claude mcp get geoserver
119
+ claude mcp remove geoserver
120
+ ```
121
+
122
+ ### Dynamic Configuration (No Hardcoded Credentials)
123
+
124
+ You can omit the `env` section entirely. The AI will ask you for the GeoServer URL, username, and password at runtime:
125
+
126
+ ```json
127
+ {
128
+ "mcpServers": {
129
+ "geoserver": {
130
+ "command": "uvx",
131
+ "args": ["geoservercloud-mcp"]
132
+ }
133
+ }
134
+ }
135
+ ```
136
+
137
+ ---
138
+
139
+ ## Environment Variables
140
+
141
+ | Variable | Default | Description |
142
+ | -------------------- | --------------------------------- | ------------------ |
143
+ | `GEOSERVER_URL` | `http://localhost:8080/geoserver` | GeoServer base URL |
144
+ | `GEOSERVER_USER` | `admin` | GeoServer username |
145
+ | `GEOSERVER_PASSWORD` | `geoserver` | GeoServer password |
146
+
147
+ ---
148
+
149
+ ## Python Library
150
+
151
+ This MCP server is built on the **python-geoservercloud** library. For programmatic access without MCP, see the [library documentation](docs/LIBRARY.md).
152
+
153
+ ```python
154
+ from geoservercloud import GeoServerCloud
155
+
156
+ geoserver = GeoServerCloud(
157
+ url="http://localhost:8080/geoserver",
158
+ user="admin",
159
+ password="geoserver",
160
+ )
161
+ geoserver.create_workspace("my_workspace")
162
+ ```
163
+
164
+ Full documentation: <https://camptocamp.github.io/python-geoservercloud/>
165
+
166
+ ---
167
+
168
+ ## Development
169
+
170
+ For local development, testing, and publishing, see the [Developer Guide](docs/DEVELOPER.md).
geoservercloud_mcp-0.0.1/geoservercloud_mcp/__init__.py ADDED
@@ -0,0 +1,10 @@
1
+ # GeoServer MCP - FastMCP Integration for python-geoservercloud
2
+ """
3
+ This module provides an MCP (Model Context Protocol) server that wraps
4
+ the GeoServerCloud library, enabling natural language interactions with
5
+ GeoServer REST API.
6
+ """
7
+
8
+ from geoservercloud_mcp.server import main, mcp
9
+
10
+ __all__ = ["mcp", "main"]