Replace black/isort/flake8 with ruff for linting and formatting

- Update GitHub workflow to use ruff instead of separate tools
- Add ruff configuration to pyproject.toml with extended rule set
- Apply ruff formatting to existing code
- Add .claude, .vscode, demo/ to .gitignore
- Update type annotations to modern Python syntax

Author: Zsailer

.github/workflows/tests.yml

@@ -29,14 +29,11 @@ jobs:
     
     - name: Run linting
       run: |
-        # Install linting tools
-        pip install flake8 black isort
-        # Check formatting
-        black --check --diff .
-        # Check import sorting
-        isort --check-only --diff .
-        # Run flake8
-        flake8 jupyter_server_mcp tests
+        # Install ruff
+        pip install ruff
+        # Check linting and formatting
+        ruff check jupyter_server_mcp tests
+        ruff format --check jupyter_server_mcp tests
     
     - name: Run unit tests
       run: |

.gitignore

@@ -1,4 +1,7 @@
 # Byte-compiled / optimized / DLL files
+.claude
+.vscode
+demo/
 __pycache__/
 *.py[codz]
 *$py.class

jupyter_server_mcp/__init__.py

@@ -1,13 +1,13 @@
 """Jupyter Server MCP Extension with configurable tools."""
 
-from typing import Any, Dict, List
+from typing import Any
 
 from .extension import MCPExtensionApp
 
 __version__ = "0.1.0"
 
 
-def _jupyter_server_extension_points() -> List[Dict[str, Any]]:
+def _jupyter_server_extension_points() -> list[dict[str, Any]]:
     # pragma: no cover
     return [
         {

pyproject.toml

@@ -33,6 +33,9 @@ test = [
     "pytest-tornasync>=0.6.0",
     "pytest-mock>=3.10.0"
 ]
+dev = [
+    "ruff>=0.1.0"
+]
 full = [
     "jupyterlab-commands-toolkit",
     "jupyter_ai_tools>=0.2.0"
@@ -48,4 +51,41 @@ jupyter_server_mcp = "jupyter_server_mcp.extension:MCPExtensionApp"
 path = "jupyter_server_mcp/__init__.py"
 
 [tool.hatch.build.targets.wheel.shared-data]
-"jupyter-config" = "etc/jupyter"
+"jupyter-config" = "etc/jupyter"
+
+[tool.ruff]
+line-length = 88
+target-version = "py310"
+
+[tool.ruff.lint]
+extend-select = [
+    "B",   # flake8-bugbear
+    "I",   # isort
+    "ARG", # flake8-unused-arguments
+    "C4",  # flake8-comprehensions
+    "EM",  # flake8-errmsg
+    "ICN", # flake8-import-conventions
+    "ISC", # flake8-implicit-str-concat
+    "PGH", # pygrep-hooks
+    "PIE", # flake8-pie
+    "PL",  # pylint
+    "PT",  # flake8-pytest-style
+    "PTH", # flake8-use-pathlib
+    "RET", # flake8-return
+    "RUF", # Ruff-specific
+    "SIM", # flake8-simplify
+    "T20", # flake8-print
+    "UP",  # pyupgrade
+    "YTT", # flake8-2020
+    "EXE", # flake8-executable
+]
+ignore = [
+    "PLR",    # Design related pylint codes
+    "ISC001", # Conflicts with formatter
+]
+
+[tool.ruff.format]
+docstring-code-format = true
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["T20"]

tests/conftest.py

@@ -5,6 +5,7 @@
 from pathlib import Path
 
 import pytest
+from tornado.web import Application
 
 from jupyter_server_mcp.extension import MCPExtensionApp
 from jupyter_server_mcp.mcp_server import MCPServer
@@ -36,7 +37,6 @@ def mcp_extension():
 @pytest.fixture
 def mock_serverapp():
     """Create a mock Jupyter Server app for testing."""
-    from tornado.web import Application
 
     class MockServerApp:
         def __init__(self):
@@ -59,19 +59,15 @@ def warning(self, msg):
 @pytest.fixture
 def mcp_server_simple():
     """Create a simple MCP server for testing."""
-    return MCPServer(
-        port=3097, log_level="WARNING"
-    )  # Use WARNING to reduce test noise
+    return MCPServer(port=3097, log_level="WARNING")  # Use WARNING to reduce test noise
 
 
 # Pytest configuration
 def pytest_configure(config):
     """Configure pytest with custom markers."""
     config.addinivalue_line("markers", "asyncio: mark test as async")
     config.addinivalue_line("markers", "slow: mark test as slow running")
-    config.addinivalue_line(
-        "markers", "integration: mark test as integration test"
-    )
+    config.addinivalue_line("markers", "integration: mark test as integration test")
 
 
 # Auto-use asyncio for async tests

tests/test_extension.py

@@ -227,12 +227,8 @@ def test_load_function_from_string_invalid_module(self):
         """Test loading functions from non-existent modules."""
         extension = MCPExtensionApp()
 
-        with pytest.raises(
-            ImportError, match="Could not import module"
-        ):
-            extension._load_function_from_string(
-                "nonexistent_module:some_func"
-            )
+        with pytest.raises(ImportError, match="Could not import module"):
+            extension._load_function_from_string("nonexistent_module:some_func")
 
     def test_load_function_from_string_invalid_function(self):
         """Test loading non-existent functions from valid modules."""