@treedy/lsp-mcp 0.1.7 → 0.1.8

package/dist/bundled/python/src/rope_mcp/tools/__init__.py

@@ -0,0 +1,26 @@
+"""Tool implementations for Rope MCP Server."""
+
+from .hover import get_hover
+from .definition import get_definition
+from .references import get_references
+from .completions import get_completions
+from .symbols import get_symbols
+from .rename import do_rename
+from .move import do_move
+from .change_signature import do_change_signature, get_function_signature
+from .diagnostics import get_diagnostics
+from .search import get_search
+
+__all__ = [
+    "get_hover",
+    "get_definition",
+    "get_references",
+    "get_completions",
+    "get_symbols",
+    "do_rename",
+    "do_move",
+    "do_change_signature",
+    "get_function_signature",
+    "get_diagnostics",
+    "get_search",
+]

package/dist/bundled/python/src/rope_mcp/tools/change_signature.py

@@ -0,0 +1,184 @@
+"""Change signature tool implementation - modify function parameters."""
+
+from typing import Optional
+
+from rope.refactor.change_signature import ChangeSignature, ArgumentNormalizer
+
+from ..rope_client import get_client
+from ..lsp import refresh_lsp_documents
+
+
+def do_change_signature(
+    file: str,
+    line: int,
+    column: int,
+    new_params: Optional[list[str]] = None,
+    add_param: Optional[dict] = None,
+    remove_param: Optional[str] = None,
+    resources_only: bool = False,
+) -> dict:
+    """Change the signature of a function.
+
+    Args:
+        file: Absolute path to the Python file
+        line: 1-based line number of the function
+        column: 1-based column number of the function
+        new_params: Complete new parameter list (reorder/rename), e.g. ["self", "b", "a"]
+        add_param: Add a parameter, e.g. {"name": "new_param", "default": "None", "index": 1}
+        remove_param: Name of parameter to remove
+        resources_only: If True, only return what would change without applying
+
+    Returns:
+        Dict containing the changes made or error message
+
+    Examples:
+        # Reorder parameters: def foo(a, b) -> def foo(b, a)
+        change_signature(file, line, col, new_params=["self", "b", "a"])
+
+        # Add parameter: def foo(a) -> def foo(a, b=None)
+        change_signature(file, line, col, add_param={"name": "b", "default": "None"})
+
+        # Remove parameter: def foo(a, b) -> def foo(a)
+        change_signature(file, line, col, remove_param="b")
+    """
+    client = get_client()
+
+    try:
+        workspace = client.find_workspace_for_file(file)
+        project = client.get_project(workspace)
+        resource = client.get_resource(project, file)
+        source = resource.read()
+        offset = client.position_to_offset(source, line, column)
+
+        # Create change signature refactoring
+        changer = ChangeSignature(project, resource, offset)
+
+        # Get current signature info
+        signature = changer.get_args()
+        original_params = [arg[0] for arg in signature]  # Extract param names
+
+        # Build the changers list
+        changers = []
+
+        if new_params is not None:
+            # Reorder/rename parameters
+            # ArgumentNormalizer reorders arguments to match new order
+            changers.append(ArgumentNormalizer(new_params))  # type: ignore[call-arg]
+
+        if add_param is not None:
+            # Add a new parameter
+            from rope.refactor.change_signature import ArgumentAdder
+
+            name = add_param.get("name")
+            default = add_param.get("default")
+            index = add_param.get("index")
+            # If index is None, append at the end
+            if index is None:
+                index = len(original_params)
+            changers.append(ArgumentAdder(index, name, default))
+
+        if remove_param is not None:
+            # Remove a parameter
+            from rope.refactor.change_signature import ArgumentRemover
+
+            # Find the index of the parameter to remove
+            try:
+                param_index = original_params.index(remove_param)
+                changers.append(ArgumentRemover(param_index))
+            except ValueError:
+                return {
+                    "error": f"Parameter '{remove_param}' not found in function signature",
+                    "current_params": original_params,
+                }
+
+        if not changers:
+            return {
+                "error": "No changes specified. Use new_params, add_param, or remove_param.",
+                "current_params": original_params,
+            }
+
+        # Get the changes
+        changes = changer.get_changes(changers)
+
+        # Collect the changes to report
+        changed_files = []
+        for change in changes.get_changed_resources():
+            changed_files.append(change.real_path)
+
+        if resources_only:
+            return {
+                "preview": True,
+                "original_params": original_params,
+                "changed_files": changed_files,
+                "changes_count": len(changed_files),
+            }
+
+        # Apply the changes
+        project.do(changes)
+
+        # Refresh LSP documents so Pyright picks up the changes
+        refresh_lsp_documents(changed_files)
+
+        return {
+            "success": True,
+            "original_params": original_params,
+            "changed_files": changed_files,
+            "changes_count": len(changed_files),
+        }
+
+    except Exception as e:
+        return {
+            "error": str(e),
+            "file": file,
+            "line": line,
+            "column": column,
+        }
+
+
+def get_function_signature(file: str, line: int, column: int) -> dict:
+    """Get the current signature of a function.
+
+    Args:
+        file: Absolute path to the Python file
+        line: 1-based line number of the function
+        column: 1-based column number of the function
+
+    Returns:
+        Dict containing the function signature info
+    """
+    client = get_client()
+
+    try:
+        workspace = client.find_workspace_for_file(file)
+        project = client.get_project(workspace)
+        resource = client.get_resource(project, file)
+        source = resource.read()
+        offset = client.position_to_offset(source, line, column)
+
+        # Create change signature refactoring to inspect signature
+        changer = ChangeSignature(project, resource, offset)
+
+        # Get current signature info
+        # Returns list of tuples: [(name, default_value), ...]
+        signature = changer.get_args()
+
+        params = []
+        for arg in signature:
+            param_info = {"name": arg[0]}
+            if len(arg) > 1 and arg[1] is not None:
+                param_info["default"] = arg[1]
+            params.append(param_info)
+
+        return {
+            "params": params,
+            "param_names": [p["name"] for p in params],
+            "count": len(params),
+        }
+
+    except Exception as e:
+        return {
+            "error": str(e),
+            "file": file,
+            "line": line,
+            "column": column,
+        }

package/dist/bundled/python/src/rope_mcp/tools/completions.py

@@ -0,0 +1,84 @@
+"""Completions tool implementation - code completion."""
+
+from rope.contrib import codeassist
+
+from ..rope_client import get_client
+
+
+def get_completions(file: str, line: int, column: int) -> dict:
+    """Get code completion suggestions at the given position.
+
+    Args:
+        file: Absolute path to the Python file
+        line: 1-based line number
+        column: 1-based column number
+
+    Returns:
+        Dict containing completion items or error message
+    """
+    client = get_client()
+
+    try:
+        workspace = client.find_workspace_for_file(file)
+        project = client.get_project(workspace)
+        resource = client.get_resource(project, file)
+        source = resource.read()
+        offset = client.position_to_offset(source, line, column)
+
+        proposals = codeassist.code_assist(project, source, offset, resource)
+
+        # Sort proposals by relevance
+        proposals = codeassist.sorted_proposals(proposals)
+
+        completions = []
+        for proposal in proposals:
+            # Use scope instead of deprecated kind property
+            scope = getattr(proposal, "scope", None) or getattr(proposal, "kind", "")
+            item = {
+                "label": proposal.name,
+                "kind": _get_completion_kind(scope),
+                "detail": proposal.type or "",
+            }
+
+            # Add documentation if available
+            if hasattr(proposal, "get_doc") and callable(proposal.get_doc):
+                try:
+                    doc = proposal.get_doc()
+                    if doc:
+                        item["documentation"] = doc
+                except Exception:
+                    pass
+
+            completions.append(item)
+
+        return {
+            "completions": completions,
+            "count": len(completions),
+        }
+
+    except Exception as e:
+        return {
+            "error": str(e),
+            "file": file,
+            "line": line,
+            "column": column,
+        }
+
+
+def _get_completion_kind(rope_kind: str) -> str:
+    """Map Rope completion kinds to standard kinds."""
+    kind_map = {
+        "function": "Function",
+        "class": "Class",
+        "module": "Module",
+        "variable": "Variable",
+        "attribute": "Property",
+        "builtin": "Constant",
+        "parameter": "Variable",
+        "keyword": "Keyword",
+        "imported": "Module",
+        "instance": "Variable",
+        "local": "Variable",
+        "global": "Variable",
+    }
+    return kind_map.get(rope_kind, "Text")

package/dist/bundled/python/src/rope_mcp/tools/definition.py

@@ -0,0 +1,51 @@
+"""Definition tool implementation - go to definition."""
+
+from rope.contrib import codeassist
+
+from ..rope_client import get_client
+
+
+def get_definition(file: str, line: int, column: int) -> dict:
+    """Get the definition location for the symbol at the given position.
+
+    Args:
+        file: Absolute path to the Python file
+        line: 1-based line number
+        column: 1-based column number
+
+    Returns:
+        Dict containing definition location or error message
+    """
+    client = get_client()
+
+    try:
+        workspace = client.find_workspace_for_file(file)
+        project = client.get_project(workspace)
+        resource = client.get_resource(project, file)
+        source = resource.read()
+        offset = client.position_to_offset(source, line, column)
+
+        location = codeassist.get_definition_location(project, source, offset, resource)
+
+        if location and location[0] is not None:
+            def_resource, def_line = location
+            def_path = def_resource.real_path if def_resource else file
+
+            return {
+                "file": def_path,
+                "line": def_line or 1,
+                "column": 1,  # Rope doesn't provide column info
+            }
+        else:
+            return {
+                "file": None,
+                "message": "No definition found at this position",
+            }
+
+    except Exception as e:
+        return {
+            "error": str(e),
+            "file": file,
+            "line": line,
+            "column": column,
+        }

package/dist/bundled/python/src/rope_mcp/tools/diagnostics.py

@@ -0,0 +1,18 @@
+"""Diagnostics tool implementation using Pyright."""
+
+from ..pyright_client import get_pyright_client
+
+
+def get_diagnostics(path: str) -> dict:
+    """Get diagnostics (type errors, warnings) for a file or directory.
+
+    This tool uses Pyright for type checking and analysis.
+
+    Args:
+        path: Absolute path to a Python file or directory
+
+    Returns:
+        Dict containing diagnostics or error message
+    """
+    client = get_pyright_client()
+    return client.get_diagnostics(path)

package/dist/bundled/python/src/rope_mcp/tools/hover.py

@@ -0,0 +1,49 @@
+"""Hover tool implementation - get documentation at position."""
+
+from rope.contrib import codeassist
+
+from ..rope_client import get_client
+
+
+def get_hover(file: str, line: int, column: int) -> dict:
+    """Get documentation for the symbol at the given position.
+
+    Args:
+        file: Absolute path to the Python file
+        line: 1-based line number
+        column: 1-based column number
+
+    Returns:
+        Dict containing documentation or error message
+    """
+    client = get_client()
+
+    try:
+        workspace = client.find_workspace_for_file(file)
+        project = client.get_project(workspace)
+        resource = client.get_resource(project, file)
+        source = resource.read()
+        offset = client.position_to_offset(source, line, column)
+
+        doc = codeassist.get_doc(project, source, offset, resource)
+
+        if doc:
+            return {
+                "contents": doc,
+                "file": file,
+                "line": line,
+                "column": column,
+            }
+        else:
+            return {
+                "contents": None,
+                "message": "No documentation available at this position",
+            }
+
+    except Exception as e:
+        return {
+            "error": str(e),
+            "file": file,
+            "line": line,
+            "column": column,
+        }

package/dist/bundled/python/src/rope_mcp/tools/move.py

@@ -0,0 +1,81 @@
+"""Move tool implementation - move function/class to another module."""
+
+from rope.refactor.move import MoveGlobal
+
+from ..rope_client import get_client
+from ..lsp import refresh_lsp_documents
+
+
+def do_move(
+    file: str, line: int, column: int, destination: str, resources_only: bool = False
+) -> dict:
+    """Move a function or class to another module.
+
+    Args:
+        file: Absolute path to the Python file containing the symbol
+        line: 1-based line number of the symbol
+        column: 1-based column number of the symbol
+        destination: Destination module path (e.g., "mypackage.utils" or "utils.py")
+        resources_only: If True, only return what would change without applying
+
+    Returns:
+        Dict containing the changes made or error message
+    """
+    client = get_client()
+
+    try:
+        workspace = client.find_workspace_for_file(file)
+        project = client.get_project(workspace)
+        resource = client.get_resource(project, file)
+        source = resource.read()
+        offset = client.position_to_offset(source, line, column)
+
+        # Create move refactoring
+        mover = MoveGlobal(project, resource, offset)
+
+        # Get the destination resource
+        # Handle both module path (foo.bar) and file path (foo/bar.py)
+        if destination.endswith(".py"):
+            dest_resource = project.get_resource(destination)
+        else:
+            # Convert module path to file path
+            dest_path = destination.replace(".", "/") + ".py"
+            dest_resource = project.get_resource(dest_path)
+
+        # Get the changes
+        changes = mover.get_changes(dest_resource)
+
+        # Collect the changes to report
+        changed_files = []
+        for change in changes.get_changed_resources():
+            changed_files.append(change.real_path)
+
+        if resources_only:
+            return {
+                "preview": True,
+                "destination": destination,
+                "changed_files": changed_files,
+                "changes_count": len(changed_files),
+            }
+
+        # Apply the changes
+        project.do(changes)
+
+        # Refresh LSP documents so Pyright picks up the changes
+        refresh_lsp_documents(changed_files)
+
+        return {
+            "success": True,
+            "destination": destination,
+            "changed_files": changed_files,
+            "changes_count": len(changed_files),
+        }
+
+    except Exception as e:
+        return {
+            "error": str(e),
+            "file": file,
+            "line": line,
+            "column": column,
+            "destination": destination,
+        }

package/dist/bundled/python/src/rope_mcp/tools/references.py

@@ -0,0 +1,60 @@
+"""References tool implementation - find all references."""
+
+from rope.contrib import findit
+
+from ..rope_client import get_client
+
+
+def get_references(file: str, line: int, column: int) -> dict:
+    """Find all references to the symbol at the given position.
+
+    Args:
+        file: Absolute path to the Python file
+        line: 1-based line number
+        column: 1-based column number
+
+    Returns:
+        Dict containing list of references or error message
+    """
+    client = get_client()
+
+    try:
+        workspace = client.find_workspace_for_file(file)
+        project = client.get_project(workspace)
+        resource = client.get_resource(project, file)
+        source = resource.read()
+        offset = client.position_to_offset(source, line, column)
+
+        occurrences = findit.find_occurrences(
+            project, resource, offset, unsure=False, in_hierarchy=True
+        )
+
+        references = []
+        for occurrence in occurrences:
+            occ_resource = occurrence.resource
+            occ_offset = occurrence.offset
+
+            # Read source to convert offset to line/column
+            occ_source = occ_resource.read()
+            occ_line, occ_column = client.offset_to_position(occ_source, occ_offset)
+
+            references.append(
+                {
+                    "file": occ_resource.real_path,
+                    "line": occ_line,
+                    "column": occ_column,
+                }
+            )
+
+        return {
+            "references": references,
+            "count": len(references),
+        }
+
+    except Exception as e:
+        return {
+            "error": str(e),
+            "file": file,
+            "line": line,
+            "column": column,
+        }

package/dist/bundled/python/src/rope_mcp/tools/rename.py

@@ -0,0 +1,61 @@
+"""Rename tool implementation - rename refactoring."""
+
+from rope.refactor.rename import Rename
+
+from ..rope_client import get_client
+from ..lsp import refresh_lsp_documents
+
+
+def do_rename(file: str, line: int, column: int, new_name: str) -> dict:
+    """Rename the symbol at the given position.
+
+    Args:
+        file: Absolute path to the Python file
+        line: 1-based line number
+        column: 1-based column number
+        new_name: The new name for the symbol
+
+    Returns:
+        Dict containing the changes made or error message
+    """
+    client = get_client()
+
+    try:
+        workspace = client.find_workspace_for_file(file)
+        project = client.get_project(workspace)
+        resource = client.get_resource(project, file)
+        source = resource.read()
+        offset = client.position_to_offset(source, line, column)
+
+        # Create rename refactoring
+        renamer = Rename(project, resource, offset)
+
+        # Get the changes
+        changes = renamer.get_changes(new_name)
+
+        # Collect the changes to report
+        changed_files = []
+        for change in changes.get_changed_resources():
+            changed_files.append(change.real_path)
+
+        # Apply the changes
+        project.do(changes)
+
+        # Refresh LSP documents so Pyright picks up the changes
+        refresh_lsp_documents(changed_files)
+
+        return {
+            "success": True,
+            "new_name": new_name,
+            "changed_files": changed_files,
+            "changes_count": len(changed_files),
+        }
+
+    except Exception as e:
+        return {
+            "error": str(e),
+            "file": file,
+            "line": line,
+            "column": column,
+            "new_name": new_name,
+        }