chuk-mcp-vfs

Instructions

Implementation Reference

• src/chuk_mcp_vfs/vfs_tools.py:46-67 (handler)

  Core implementation of the 'read' tool handler in VFSTools class. Resolves path, reads file from VFS, decodes content, and returns ReadResponse.

  async def read(self, path: str) -> ReadResponse:
      """
      Read file contents.
  
      Args:
          path: File path (absolute or relative to cwd)
  
      Returns:
          ReadResponse with file contents
      """
      vfs = self.workspace_manager.get_current_vfs()
      resolved_path = self.workspace_manager.resolve_path(path)
  
      content = await vfs.read_file(resolved_path)
      if content is None:
          raise ValueError(f"Could not read file: {resolved_path}")
  
      content_str = content.decode("utf-8") if isinstance(content, bytes) else content
  
      return ReadResponse(
          path=resolved_path, content=content_str, size=len(content_str.encode())
      )

• src/chuk_mcp_vfs/server.py:87-91 (registration)

  MCP server tool registration for 'read', delegating to VFSTools.read method.

  @server.tool
  async def read(path: str):
      """Read file contents."""
      return await vfs_tools.read(path)

• src/chuk_mcp_vfs/models.py:130-136 (schema)

  Pydantic model defining the output schema for the 'read' tool response.

  class ReadResponse(BaseModel):
      """Response from read operation"""
  
      path: str
      content: str
      size: int