mcp-server-code-assist 0.1.2__tar.gz → 0.1.3__tar.gz

{mcp_server_code_assist-0.1.2 → mcp_server_code_assist-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-server-code-assist
-Version: 0.1.2
+Version: 0.1.3
 Summary: MCP Code Assist Server
 Requires-Python: >=3.11
 Requires-Dist: aiofiles>=24.0.0
@@ -8,6 +8,7 @@ Requires-Dist: click>=8.1.7
 Requires-Dist: gitpython>=3.1.40
 Requires-Dist: mcp>=1.2.0
 Requires-Dist: pydantic>=2.0.0
+Requires-Dist: xmlschema>=3.4.3
 Provides-Extra: test
 Requires-Dist: pytest-asyncio>=0.25.0; extra == 'test'
 Requires-Dist: pytest>=8.0.0; extra == 'test'

{mcp_server_code_assist-0.1.2 → mcp_server_code_assist-0.1.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mcp-server-code-assist"
-version = "0.1.2"
+version = "0.1.3"
 description = "MCP Code Assist Server"
 requires-python = ">=3.11"
 dependencies = [
@@ -8,7 +8,8 @@ dependencies = [
     "gitpython>=3.1.40",
     "pydantic>=2.0.0",
     "click>=8.1.7",
-    "mcp>=1.2.0"
+    "mcp>=1.2.0",
+    "xmlschema>=3.4.3"
 ]
 
 [project.scripts]

mcp_server_code_assist-0.1.3/res/cmds.md

@@ -0,0 +1,27 @@
+
+# Run locally
+
+
+
+```
+source .venv/bin/activate
+noglob uv pip install -e .[test]
+uv run mcp-server-code-assist
+```
+
+
+# Install uvx
+
+```
+uvx mcp-server-code-assist
+```
+
+# Build
+
+```
+noglob uv pip install -e .[test]
+uv sync
+uv pip install build twine
+python -m build
+python -m twine upload dist/*
+```

mcp_server_code_assist-0.1.3/res/mcp-cli.md

@@ -0,0 +1,45 @@
+# Quickstart
+
+Let's create a simple MCP server that exposes a calculator tool and some data:
+
+# server.py
+```python
+from mcp.server.fastmcp import FastMCP
+```
+
+
+# Create an MCP server
+```python
+mcp = FastMCP("Demo")
+```
+
+
+# Add an addition tool
+```python
+@mcp.tool()
+def add(a: int, b: int) -> int:
+    """Add two numbers"""
+    return a + b
+```
+
+
+# Add a dynamic greeting resource
+```python
+@mcp.resource("greeting://{name}")
+def get_greeting(name: str) -> str:
+    """Get a personalized greeting"""
+    return f"Hello, {name}!"
+```
+
+
+You can install this server in [Claude Desktop](https://claude.ai/download) and interact with it right away by running:
+
+```bash
+mcp install server.py
+```
+
+Alternatively, you can test it with the MCP Inspector:
+
+```bash
+mcp dev server.py
+```

{mcp_server_code_assist-0.1.2 → mcp_server_code_assist-0.1.3/res}/plan.md

@@ -16,15 +16,20 @@
   - [x] Implement parse/generate methods
   - [x] Add tests
 
-- [x] File Tools
-  - [x] create function
-  - [x] delete function  
-  - [x] modify with search/replace
-  - [x] rewrite function
-  - [x] diff generation
-  - [x] directory tree with gitignore
-  - [x] file search
-  - [x] file operations tests
+- [ ] File Tools
+  - [ ] Read Operations
+    - [x] read_file function
+    - [x] list_directory function
+    - [ ] file_tree function (with .gitignore support)
+  - [x] Write Operations
+    - [x] create function
+    - [x] delete function  
+    - [x] modify with search/replace
+    - [x] rewrite function
+    - [x] diff generation
+    - [x] directory tree with gitignore
+    - [x] file search
+    - [x] file operations tests
 
 - [x] Git Operations
   - [x] Repository tools implementation
@@ -38,6 +43,7 @@
   - [ ] OpenRouter integration
   - [ ] Command line interface
   - [ ] XML instruction processing
+  - [ ] Read operations implementation
   - [x] Basic request handlers
   - [x] Error handling
   - [x] Request validation
@@ -68,10 +74,11 @@ Proposed Solutions:
 - Design instruction format to be resumable
 
 ## Current Task
-Phase 1: Read-only operations
-- File read operations complete
-- Git read operations complete
-- File write operations to be implemented directly
+Phase 1: Complete Implementation
+- File read operations (read_file, list_directory, file_tree)
+- File write operations
+- Git operations
+- XML instruction processing
 
 Phase 2:
 - OpenRouter integration

{mcp_server_code_assist-0.1.2 → mcp_server_code_assist-0.1.3}/src/mcp_server_code_assist/server.py

@@ -1,5 +1,6 @@
 import logging
 import os
+import json
 from pathlib import Path
 from typing import Any
 from enum import Enum
@@ -9,18 +10,20 @@ from mcp.server.stdio import stdio_server
 from mcp.types import ClientCapabilities, TextContent, Tool, ListRootsResult, RootsCapability
 import git
 from mcp_server_code_assist.tools.models import (
-    FileCreate, FileDelete, FileModify, FileRewrite,
+    FileCreate, FileDelete, FileModify, FileRewrite, FileRead,
     GitBase, GitAdd, GitCommit, GitDiff, GitCreateBranch,
-    GitCheckout, GitShow, GitLog
+    GitCheckout, GitShow, GitLog, ListDirectory
 )
 from mcp_server_code_assist.tools.file_tools import FileTools
 from mcp_server_code_assist.tools.git_functions import git_status, git_diff_unstaged, git_diff_staged, git_diff, git_log, git_show
 
 class CodeAssistTools(str, Enum):
+    LIST_DIRECTORY = "list_directory"
     FILE_CREATE = "file_create"
     FILE_DELETE = "file_delete" 
     FILE_MODIFY = "file_modify"
     FILE_REWRITE = "file_rewrite"
+    FILE_READ = "file_read"
     GIT_STATUS = "git_status"
     GIT_DIFF_UNSTAGED = "git_diff_unstaged"
     GIT_DIFF_STAGED = "git_diff_staged"
@@ -81,6 +84,11 @@ async def serve(working_dir: Path | None) -> None:
     @server.list_tools()
     async def list_tools() -> list[Tool]:
         return [
+            Tool(
+                name=CodeAssistTools.LIST_DIRECTORY,
+                description="Lists contents of a directory",
+                inputSchema=ListDirectory.schema(),
+            ),
             Tool(
                 name=CodeAssistTools.FILE_CREATE,
                 description="Creates a new file with content",
@@ -101,6 +109,11 @@ async def serve(working_dir: Path | None) -> None:
                 description="Rewrites entire file content",
                 inputSchema=FileRewrite.schema(),
             ),
+            Tool(
+                name=CodeAssistTools.FILE_READ,
+                description="Reads contents of a file",
+                inputSchema=FileRead.schema(),
+            ),
             Tool(
                 name=CodeAssistTools.GIT_STATUS,
                 description="Shows the working tree status",
@@ -161,6 +174,14 @@ async def serve(working_dir: Path | None) -> None:
     @server.call_tool()
     async def call_tool(name: str, arguments: dict) -> list[TextContent]:
         match name:
+            case CodeAssistTools.LIST_DIRECTORY:
+                result = await FileTools.list_directory(
+                    arguments["path"],
+                    arguments.get("recursive", False),
+                    arguments.get("include_hidden", False)
+                )
+                return [TextContent(type="text", text=json.dumps(result, indent=2))]
+
             case CodeAssistTools.FILE_CREATE:
                 result = await FileTools.create_file(arguments["path"], arguments.get("content", ""))
                 return [TextContent(type="text", text=result)]
@@ -177,6 +198,10 @@ async def serve(working_dir: Path | None) -> None:
                 result = await FileTools.rewrite_file(arguments["path"], arguments["content"])
                 return [TextContent(type="text", text=result)]
 
+            case CodeAssistTools.FILE_READ:
+                content = await FileTools.read_file(arguments["path"])
+                return [TextContent(type="text", text=content)]
+
             case CodeAssistTools.GIT_STATUS:
                 repo = git.Repo(arguments["repo_path"])
                 status = git_status(repo)

{mcp_server_code_assist-0.1.2 → mcp_server_code_assist-0.1.3}/src/mcp_server_code_assist/tools/file_tools.py

@@ -90,12 +90,51 @@ class FileTools:
         return ''.join(diff)
 
     @classmethod
-    async def list_directory(cls, path: str) -> list[str]:
+    async def list_directory(cls, path: str, recursive: bool = False, include_hidden: bool = False) -> list[dict]:
+        """List contents of a directory.
+        
+        Args:
+            path: Directory path to list
+            recursive: Whether to list subdirectories recursively
+            include_hidden: Whether to include hidden files/directories
+            
+        Returns:
+            List of dicts with file/directory info:
+            {
+                "name": str,
+                "path": str,
+                "type": "file"|"directory",
+                "size": int,  # for files only
+                "children": list  # for directories when recursive=True
+            }
+        """
         path = await cls.validate_path(path)
-        entries = []
-        for item in Path(path).iterdir():
-            entries.append(str(item))
-        return entries
+        if not os.path.isdir(path):
+            raise ValueError(f"Path {path} is not a directory")
+            
+        result = []
+        for entry in os.scandir(path):
+            if not include_hidden and entry.name.startswith('.'):
+                continue
+                
+            info = {
+                "name": entry.name,
+                "path": str(Path(entry.path).relative_to(path)),
+                "type": "directory" if entry.is_dir() else "file",
+            }
+            
+            if entry.is_file():
+                info["size"] = entry.stat().st_size
+            elif recursive and entry.is_dir():
+                info["children"] = await cls.list_directory(
+                    entry.path,
+                    recursive=True,
+                    include_hidden=include_hidden
+                )
+                
+            result.append(info)
+            
+        return result
 
     @classmethod
     async def create_directory(cls, path: str) -> None:

{mcp_server_code_assist-0.1.2 → mcp_server_code_assist-0.1.3}/src/mcp_server_code_assist/tools/models.py

@@ -13,6 +13,9 @@ class FileModify(BaseModel):
     path: Union[str, Path]
     replacements: dict[str, str]
 
+class FileRead(BaseModel):
+    path: Union[str, Path]
+
 class FileRewrite(BaseModel):
     path: Union[str, Path]
     content: str
@@ -42,6 +45,11 @@ class GitShow(GitBase):
 class GitLog(GitBase):
     max_count: int = 10
 
+class ListDirectory(BaseModel):
+    path: Union[str, Path]
+    recursive: bool = False
+    include_hidden: bool = False
+
 class RepositoryOperation(BaseModel):
     path: str
     content: Optional[str] = None

{mcp_server_code_assist-0.1.2 → mcp_server_code_assist-0.1.3}/tests/test_file_operations.py

@@ -51,14 +51,37 @@ async def test_read_multiple_files():
 
 @pytest.mark.asyncio
 async def test_list_directory():
-    test_file = TEST_DIR / "test.txt"
-    test_dir = TEST_DIR / "test_dir"
-    await FileTools.write_file(str(test_file), "content")
-    test_dir.mkdir()
-    
-    entries = await FileTools.list_directory(str(TEST_DIR))
-    assert any(entry.endswith("test.txt") for entry in entries)
-    assert any(entry.endswith("test_dir") for entry in entries)
+    # Create test structure
+    (TEST_DIR / "dir1").mkdir()
+    (TEST_DIR / "dir1" / "file1.txt").write_text("content1")
+    (TEST_DIR / "dir1" / "file2.txt").write_text("content2")
+    (TEST_DIR / "dir1" / "subdir").mkdir()
+    (TEST_DIR / "dir1" / "subdir" / "file3.txt").write_text("content3")
+    (TEST_DIR / ".hidden_dir").mkdir()
+    (TEST_DIR / ".hidden_file").write_text("hidden")
+
+    # Test basic listing
+    result = await FileTools.list_directory(str(TEST_DIR / "dir1"), recursive=False, include_hidden=False)
+    assert len(result) == 3
+    assert any(item["name"] == "file1.txt" and item["type"] == "file" for item in result)
+    assert any(item["name"] == "file2.txt" and item["type"] == "file" for item in result)
+    assert any(item["name"] == "subdir" and item["type"] == "directory" for item in result)
+
+    # Test recursive listing
+    result = await FileTools.list_directory(str(TEST_DIR / "dir1"), recursive=True, include_hidden=False)
+    assert len(result) == 3
+    subdir = next(item for item in result if item["name"] == "subdir")
+    assert "children" in subdir
+    assert len(subdir["children"]) == 1
+    assert subdir["children"][0]["name"] == "file3.txt"
+
+    # Test hidden files
+    result = await FileTools.list_directory(str(TEST_DIR), recursive=False, include_hidden=True)
+    assert any(item["name"].startswith(".hidden") for item in result)
+
+    # Test error on non-directory
+    with pytest.raises(ValueError):
+        await FileTools.list_directory(str(TEST_DIR / "dir1" / "file1.txt"))
 
 @pytest.mark.asyncio
 async def test_directory_tree():

{mcp_server_code_assist-0.1.2 → mcp_server_code_assist-0.1.3}/uv.lock

@@ -63,6 +63,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335 },
 ]
 
+[[package]]
+name = "elementpath"
+version = "4.7.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/3e/44/7a10be09cb79d4e6900fc1f2a7db6fb7639c6b05f88b61106650b618fc52/elementpath-4.7.0.tar.gz", hash = "sha256:a2029dc8752fcfec49663d1ed1b412c6daf278c0c91938f50f63c4fe9ed1848e", size = 357225 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b8/eb/c4fac84745a84d3bc0fd481cf8c204f60bce367a19d8f9182a195ed6d42a/elementpath-4.7.0-py3-none-any.whl", hash = "sha256:607804a1b4250ac448c1e2bfaec4ee1c980b0a07cfdb0d9057b57102038ed480", size = 240649 },
+]
+
 [[package]]
 name = "gitdb"
 version = "4.0.12"
@@ -172,7 +181,7 @@ wheels = [
 
 [[package]]
 name = "mcp-server-code-assist"
-version = "0.1.2"
+version = "0.1.3"
 source = { editable = "." }
 dependencies = [
     { name = "aiofiles" },
@@ -180,6 +189,7 @@ dependencies = [
     { name = "gitpython" },
     { name = "mcp" },
     { name = "pydantic" },
+    { name = "xmlschema" },
 ]
 
 [package.optional-dependencies]
@@ -197,6 +207,7 @@ requires-dist = [
     { name = "pydantic", specifier = ">=2.0.0" },
     { name = "pytest", marker = "extra == 'test'", specifier = ">=8.0.0" },
     { name = "pytest-asyncio", marker = "extra == 'test'", specifier = ">=0.25.0" },
+    { name = "xmlschema", specifier = ">=3.4.3" },
 ]
 
 [[package]]
@@ -397,3 +408,15 @@ sdist = { url = "https://files.pythonhosted.org/packages/4b/4d/938bd85e5bf2edeec
 wheels = [
     { url = "https://files.pythonhosted.org/packages/61/14/33a3a1352cfa71812a3a21e8c9bfb83f60b0011f5e36f2b1399d51928209/uvicorn-0.34.0-py3-none-any.whl", hash = "sha256:023dc038422502fa28a09c7a30bf2b6991512da7dcdb8fd35fe57cfc154126f4", size = 62315 },
 ]
+
+[[package]]
+name = "xmlschema"
+version = "3.4.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "elementpath" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/11/ca/56579e6b4558c3c06902fe6647280345da8087f080c86e85166fd2131f8d/xmlschema-3.4.3.tar.gz", hash = "sha256:0c638dac81c7d6c9da9a8d7544402c48cffe7ee0e13cc47fc0c18794d1395dfb", size = 585144 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/5a/49/ff75976757b23d6345ec1021fd0d2480d7ceed66d285e31556ac1147858d/xmlschema-3.4.3-py3-none-any.whl", hash = "sha256:eea4e5a1aac041b546ebe7b2eb68eb5eaebf5c5258e573cfc182375676b2e4e3", size = 417847 },
+]