geoservercloud-mcp 0.1.5__tar.gz → 0.1.7__tar.gz

{geoservercloud_mcp-0.1.5 → geoservercloud_mcp-0.1.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: geoservercloud-mcp
-Version: 0.1.5
+Version: 0.1.7
 Summary: MCP (Model Context Protocol) server for GeoServer - enables AI assistants to manage GeoServer workspaces, datastores, layers, and styles through natural language
 License: BSD-2-Clause
 License-File: LICENSE
@@ -28,7 +28,7 @@ Description-Content-Type: text/markdown
 
 # GeoServer MCP Server
 
-mcp-name:io.github.ronitjadhav/geoservercloud-mcp
+<!-- mcp-name: io.github.ronitjadhav/geoservercloud-mcp -->
 
 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.
 
@@ -47,32 +47,30 @@ Once connected, you can ask your AI assistant things like:
 
 ---
 
-## Quick Start
+## Installation
 
-### Option 1: Full Local Development Stack
-
-Start the MCP server with a local GeoServer and PostGIS:
+### From PyPI
 
 ```bash
-cd mcp
-docker compose up -d
+pip install geoservercloud-mcp
 ```
 
-This starts:
-- **geoservercloud-mcp**: The MCP server on port 8000
-- **geoserver**: GeoServer instance on port 8080
-- **postgis**: PostGIS database on port 5433
+Or use `uvx` to run without installing (requires [uv](https://docs.astral.sh/uv/)):
 
-### Option 2: MCP Server Only (Connect to External GeoServer)
+```bash
+# Install uv first (if not already installed)
+curl -LsSf https://astral.sh/uv/install.sh | sh
 
-If you have an existing GeoServer:
+# Run the MCP server
+uvx geoservercloud-mcp
+```
 
-```bash
-cd mcp
-GEOSERVER_URL=http://your-geoserver:8080/geoserver \
-GEOSERVER_USER=admin \
-GEOSERVER_PASSWORD=your-password \
-docker compose up -d geoservercloud-mcp
+### From MCP Registry
+
+This server is published to the [MCP Registry](https://registry.modelcontextprotocol.io) as:
+
+```text
+io.github.ronitjadhav/geoservercloud-mcp
 ```
 
 ---
@@ -81,21 +79,14 @@ docker compose up -d geoservercloud-mcp
 
 ### VS Code / Cursor
 
-1. Open Command Palette → **"MCP: Add Server"**
-2. Select **"Command (stdio)"**
-3. Enter command: `poetry run geoservercloud-mcp`
-4. Enter server ID: `geoserver`
-
-VS Code will create an MCP configuration file. Update it with the working directory and environment variables:
+Add to your MCP configuration (`.vscode/mcp.json`):
 
 ```json
 {
   "servers": {
     "geoserver": {
-      "type": "stdio",
-      "command": "poetry",
-      "args": ["run", "geoservercloud-mcp"],
-      "cwd": "/path/to/python-geoservercloud",
+      "command": "uvx",
+      "args": ["geoservercloud-mcp"],
       "env": {
         "GEOSERVER_URL": "http://localhost:8080/geoserver",
         "GEOSERVER_USER": "admin",
@@ -117,9 +108,8 @@ Add to your Claude Desktop config:
 {
   "mcpServers": {
     "geoserver": {
-      "command": "poetry",
-      "args": ["run", "geoservercloud-mcp"],
-      "cwd": "/path/to/python-geoservercloud",
+      "command": "uvx",
+      "args": ["geoservercloud-mcp"],
       "env": {
         "GEOSERVER_URL": "http://localhost:8080/geoserver",
         "GEOSERVER_USER": "admin",
@@ -132,20 +122,21 @@ Add to your Claude Desktop config:
 
 Restart Claude Desktop after saving the configuration.
 
----
-
-## Testing with FastMCP Inspector
+### Dynamic Configuration (No Hardcoded Credentials)
 
-The MCP server includes a built-in inspector UI for debugging:
+You can omit the `env` section entirely. The AI will ask you for the GeoServer URL, username, and password at runtime:
 
-```bash
-# From project root
-poetry install
-poetry run fastmcp dev geoservercloud/mcp/server.py
+```json
+{
+  "mcpServers": {
+    "geoserver": {
+      "command": "uvx",
+      "args": ["geoservercloud-mcp"]
+    }
+  }
+}
 ```
 
-Open http://127.0.0.1:6274 in your browser to test individual tools.
-
 ---
 
 ## Environment Variables
@@ -158,25 +149,6 @@ Open http://127.0.0.1:6274 in your browser to test individual tools.
 
 ---
 
-## Docker Commands
-
-```bash
-# Start all services
-cd mcp
-docker compose up -d
-
-# Stop services
-docker compose down
-
-# Stop and remove volumes (data)
-docker compose down -v
-
-# View logs
-docker compose logs -f geoservercloud-mcp
-```
-
----
-
 ## Python Library
 
 This MCP server is built on the **python-geoservercloud** library. For programmatic access without MCP, see the [library documentation](docs/LIBRARY.md).
@@ -194,3 +166,9 @@ geoserver.create_workspace("my_workspace")
 
 Full documentation: <https://camptocamp.github.io/python-geoservercloud/>
 
+---
+
+## Development
+
+For local development, testing, and publishing, see the [Developer Guide](docs/DEVELOPER.md).
+

{geoservercloud_mcp-0.1.5 → geoservercloud_mcp-0.1.7}/README.md

@@ -1,6 +1,6 @@
 # GeoServer MCP Server
 
-mcp-name:io.github.ronitjadhav/geoservercloud-mcp
+<!-- mcp-name: io.github.ronitjadhav/geoservercloud-mcp -->
 
 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.
 
@@ -19,32 +19,30 @@ Once connected, you can ask your AI assistant things like:
 
 ---
 
-## Quick Start
+## Installation
 
-### Option 1: Full Local Development Stack
-
-Start the MCP server with a local GeoServer and PostGIS:
+### From PyPI
 
 ```bash
-cd mcp
-docker compose up -d
+pip install geoservercloud-mcp
 ```
 
-This starts:
-- **geoservercloud-mcp**: The MCP server on port 8000
-- **geoserver**: GeoServer instance on port 8080
-- **postgis**: PostGIS database on port 5433
+Or use `uvx` to run without installing (requires [uv](https://docs.astral.sh/uv/)):
 
-### Option 2: MCP Server Only (Connect to External GeoServer)
+```bash
+# Install uv first (if not already installed)
+curl -LsSf https://astral.sh/uv/install.sh | sh
 
-If you have an existing GeoServer:
+# Run the MCP server
+uvx geoservercloud-mcp
+```
 
-```bash
-cd mcp
-GEOSERVER_URL=http://your-geoserver:8080/geoserver \
-GEOSERVER_USER=admin \
-GEOSERVER_PASSWORD=your-password \
-docker compose up -d geoservercloud-mcp
+### From MCP Registry
+
+This server is published to the [MCP Registry](https://registry.modelcontextprotocol.io) as:
+
+```text
+io.github.ronitjadhav/geoservercloud-mcp
 ```
 
 ---
@@ -53,21 +51,14 @@ docker compose up -d geoservercloud-mcp
 
 ### VS Code / Cursor
 
-1. Open Command Palette → **"MCP: Add Server"**
-2. Select **"Command (stdio)"**
-3. Enter command: `poetry run geoservercloud-mcp`
-4. Enter server ID: `geoserver`
-
-VS Code will create an MCP configuration file. Update it with the working directory and environment variables:
+Add to your MCP configuration (`.vscode/mcp.json`):
 
 ```json
 {
   "servers": {
     "geoserver": {
-      "type": "stdio",
-      "command": "poetry",
-      "args": ["run", "geoservercloud-mcp"],
-      "cwd": "/path/to/python-geoservercloud",
+      "command": "uvx",
+      "args": ["geoservercloud-mcp"],
       "env": {
         "GEOSERVER_URL": "http://localhost:8080/geoserver",
         "GEOSERVER_USER": "admin",
@@ -89,9 +80,8 @@ Add to your Claude Desktop config:
 {
   "mcpServers": {
     "geoserver": {
-      "command": "poetry",
-      "args": ["run", "geoservercloud-mcp"],
-      "cwd": "/path/to/python-geoservercloud",
+      "command": "uvx",
+      "args": ["geoservercloud-mcp"],
       "env": {
         "GEOSERVER_URL": "http://localhost:8080/geoserver",
         "GEOSERVER_USER": "admin",
@@ -104,20 +94,21 @@ Add to your Claude Desktop config:
 
 Restart Claude Desktop after saving the configuration.
 
----
-
-## Testing with FastMCP Inspector
+### Dynamic Configuration (No Hardcoded Credentials)
 
-The MCP server includes a built-in inspector UI for debugging:
+You can omit the `env` section entirely. The AI will ask you for the GeoServer URL, username, and password at runtime:
 
-```bash
-# From project root
-poetry install
-poetry run fastmcp dev geoservercloud/mcp/server.py
+```json
+{
+  "mcpServers": {
+    "geoserver": {
+      "command": "uvx",
+      "args": ["geoservercloud-mcp"]
+    }
+  }
+}
 ```
 
-Open http://127.0.0.1:6274 in your browser to test individual tools.
-
 ---
 
 ## Environment Variables
@@ -130,25 +121,6 @@ Open http://127.0.0.1:6274 in your browser to test individual tools.
 
 ---
 
-## Docker Commands
-
-```bash
-# Start all services
-cd mcp
-docker compose up -d
-
-# Stop services
-docker compose down
-
-# Stop and remove volumes (data)
-docker compose down -v
-
-# View logs
-docker compose logs -f geoservercloud-mcp
-```
-
----
-
 ## Python Library
 
 This MCP server is built on the **python-geoservercloud** library. For programmatic access without MCP, see the [library documentation](docs/LIBRARY.md).
@@ -165,3 +137,9 @@ geoserver.create_workspace("my_workspace")
 ```
 
 Full documentation: <https://camptocamp.github.io/python-geoservercloud/>
+
+---
+
+## Development
+
+For local development, testing, and publishing, see the [Developer Guide](docs/DEVELOPER.md).

{geoservercloud_mcp-0.1.5 → geoservercloud_mcp-0.1.7}/geoservercloud/mcp/server.py

@@ -11,7 +11,6 @@ Configuration via environment variables:
 """
 
 import os
-from functools import lru_cache
 from typing import Any
 
 from fastmcp import FastMCP
@@ -24,6 +23,11 @@ mcp = FastMCP(
     instructions="""
     GeoServer MCP provides tools for managing GeoServer via natural language.
     
+    IMPORTANT: Before using any GeoServer tools, you should:
+    1. First call get_geoserver_connection_info() to check if configured
+    2. If not configured or using wrong server, call configure_geoserver_connection()
+       to set the GeoServer URL, username, and password
+    
     Available capabilities:
     - Workspaces: Create, list, get, delete workspaces
     - Datastores: Manage PostGIS, JNDI, PMTiles, and generic datastores
@@ -35,23 +39,22 @@ mcp = FastMCP(
     - Users & Roles: Manage GeoServer security
     - ACL Rules: Configure access control
     - OGC Services: WMS GetMap, WFS GetFeature, WMTS GetTile
-    
-    Before using tools, ensure GeoServer connection is configured via:
-    - GEOSERVER_URL environment variable
-    - GEOSERVER_USER environment variable  
-    - GEOSERVER_PASSWORD environment variable
     """,
 )
 
 
-@lru_cache(maxsize=1)
+# Mutable configuration that can be updated at runtime
+_geoserver_config: dict[str, str] = {
+    "url": os.getenv("GEOSERVER_URL", "http://localhost:8080/geoserver"),
+    "user": os.getenv("GEOSERVER_USER", "admin"),
+    "password": os.getenv("GEOSERVER_PASSWORD", "geoserver"),
+    "configured": "false" if not os.getenv("GEOSERVER_URL") else "true",
+}
+
+
 def get_geoserver_config() -> dict[str, str]:
-    """Get GeoServer configuration from environment variables."""
-    return {
-        "url": os.getenv("GEOSERVER_URL", "http://localhost:8080/geoserver"),
-        "user": os.getenv("GEOSERVER_USER", "admin"),
-        "password": os.getenv("GEOSERVER_PASSWORD", "geoserver"),
-    }
+    """Get current GeoServer configuration."""
+    return _geoserver_config
 
 
 def get_geoserver() -> GeoServerCloud:
@@ -74,13 +77,45 @@ def get_geoserver_connection_info() -> dict[str, str]:
     """
     Get current GeoServer connection information.
     Shows the configured URL and username (password is hidden).
+    Check 'configured' field to see if connection was explicitly set.
+    If configured is 'false', ask the user for connection details
+    and use configure_geoserver_connection() to set them.
     """
     config = get_geoserver_config()
     return {
         "url": config["url"],
         "user": config["user"],
         "password": "***hidden***",
-        "status": "configured",
+        "configured": config["configured"],
+    }
+
+
+@mcp.tool
+def configure_geoserver_connection(
+    url: str,
+    user: str = "admin",
+    password: str = "geoserver",
+) -> dict[str, str]:
+    """
+    Configure the GeoServer connection at runtime.
+    Use this to set the GeoServer URL and credentials when they are not
+    pre-configured via environment variables.
+
+    Args:
+        url: GeoServer base URL (e.g., http://localhost:8080/geoserver)
+        user: GeoServer username (default: admin)
+        password: GeoServer password (default: geoserver)
+    """
+    _geoserver_config["url"] = url
+    _geoserver_config["user"] = user
+    _geoserver_config["password"] = password
+    _geoserver_config["configured"] = "true"
+
+    return {
+        "message": f"GeoServer connection configured: {url}",
+        "url": url,
+        "user": user,
+        "configured": "true",
     }
 
 

{geoservercloud_mcp-0.1.5 → geoservercloud_mcp-0.1.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "geoservercloud-mcp"
-version = "0.1.5"
+version = "0.1.7"
 description = "MCP (Model Context Protocol) server for GeoServer - enables AI assistants to manage GeoServer workspaces, datastores, layers, and styles through natural language"
 authors = ["Ronit Jadhav <ronit.jadhav@camptocamp.com>"]
 license = "BSD-2-Clause"