adds directory upload.

Author: filiplajszczak

README.md

@@ -34,6 +34,10 @@ Have your PythonAnywhere API token and username ready. You can find (or
 generate) your API token in the [API section of your PythonAnywhere
 account](https://www.pythonanywhere.com/account/#api_token).
 
+If your account is on `eu.pythonanywhere.com`, you also need to set
+`PYTHONANYWHERE_SITE` to `eu.pythonanywhere.com` (it defaults to
+`www.pythonanywhere.com`).
+
 ### Desktop Extension - works with Claude Desktop
 Probably the most straightforward way to install the MCP server is to use
 the [desktop extension](https://github.com/anthropics/dxt/) for Claude Desktop.
@@ -49,7 +53,7 @@ Run:
    ```bash
    claude mcp add pythonanywhere-mcp-server \
    -e API_TOKEN=yourpythonanywhereapitoken \
-   -e LOGNAME=yourpythonanywhereusername \
+   -e PYTHONANYWHERE_USERNAME=yourpythonanywhereusername \
    -- uvx pythonanywhere-mcp-server
    ```
 
@@ -65,7 +69,7 @@ Add it to your `mcp.json`.
       "args": ["pythonanywhere-mcp-server"],
       "env": {
         "API_TOKEN": "yourpythonanywhereapitoken",
-        "LOGNAME": "yourpythonanywhereusername"
+        "PYTHONANYWHERE_USERNAME": "yourpythonanywhereusername"
       }
     }
   }
@@ -85,7 +89,7 @@ for Cursor).
       "args": ["pythonanywhere-mcp-server"],
       "env": {
         "API_TOKEN": "yourpythonanywhereapitoken",
-        "LOGNAME": "yourpythonanywhereusername"
+        "PYTHONANYWHERE_USERNAME": "yourpythonanywhereusername"
       }
     }
   }

manifest.json

@@ -21,6 +21,12 @@
       "title": "PythonAnywhere Username",
       "description": "Your PythonAnywhere username",
       "required": true
+    },
+    "pa_site": {
+      "type": "string",
+      "title": "PythonAnywhere Site",
+      "description": "Set to eu.pythonanywhere.com if your account is on the EU site (defaults to www.pythonanywhere.com)",
+      "required": false
     }
   },
   "server": {
@@ -31,7 +37,8 @@
       "args": ["pythonanywhere-mcp-server"],
       "env": {
         "API_TOKEN": "${user_config.pa_api_token}",
-        "LOGNAME": "${user_config.pa_username}"
+        "PYTHONANYWHERE_USERNAME": "${user_config.pa_username}",
+        "PYTHONANYWHERE_SITE": "${user_config.pa_site}"
       }
     }
   }

pyproject.toml

@@ -12,7 +12,7 @@ authors = [
 readme = "README.md"
 requires-python = ">=3.13"
 dependencies = [
-    "pythonanywhere-core>=0.2.9",
+    "pythonanywhere-core>=0.3.0",
     "mcp[cli]",
 ]
 classifiers = [

src/pythonanywhere_mcp_server/tools/file.py

@@ -44,6 +44,27 @@ def upload_text_file(dest_path: str, content: str) -> str:
         except Exception as exc:
             raise RuntimeError(f"Failed to upload text file: {str(exc)}") from exc
 
+    @mcp.tool()
+    def upload_directory(local_dir_path: str, remote_dir_path: str) -> str:
+        """
+        Upload a local directory to PythonAnywhere, preserving directory structure.
+
+        Recursively walks the local directory and uploads each file.
+        Empty directories are preserved.
+
+        Args:
+            local_dir_path (str): The absolute path to the local directory to upload.
+            remote_dir_path (str): The absolute path on PythonAnywhere where the directory will be uploaded.
+
+        Returns:
+            str: Status message indicating upload result.
+        """
+        try:
+            Files().tree_post(local_dir_path, remote_dir_path)
+            return f"Uploaded {local_dir_path} to {remote_dir_path}."
+        except Exception as exc:
+            raise RuntimeError(f"Failed to upload directory: {str(exc)}") from exc
+
     @mcp.tool()
     def delete_path(path: str) -> str:
         """

tests/test_file_tools.py

@@ -62,6 +62,23 @@ def test_delete_path_exception(mcp, mocker):
     assert "Failed to delete path: delete error" in str(exc)
 
 
+def test_upload_directory(mcp, mocker):
+    file_tools.register_file_tools(mcp)
+    mock_files = mocker.patch("tools.file.Files", autospec=True)
+    result = mcp.call_tool("upload_directory", {"local_dir_path": "/local/myapp", "remote_dir_path": "/home/user/myapp"})
+    mock_files.return_value.tree_post.assert_called_with("/local/myapp", "/home/user/myapp")
+    assert result == "Uploaded /local/myapp to /home/user/myapp."
+
+
+def test_upload_directory_exception(mcp, mocker):
+    file_tools.register_file_tools(mcp)
+    mock_files = mocker.patch("tools.file.Files", autospec=True)
+    mock_files.return_value.tree_post.side_effect = Exception("upload dir error")
+    with pytest.raises(RuntimeError) as exc:
+        mcp.call_tool("upload_directory", {"local_dir_path": "/local/myapp", "remote_dir_path": "/home/user/myapp"})
+    assert "Failed to upload directory: upload dir error" in str(exc)
+
+
 def test_directory_tree(mcp, mocker):
     file_tools.register_file_tools(mcp)
     mock_files = mocker.patch("tools.file.Files", autospec=True)