v0.1.2: Improved file path handling & user experience
π Major User Experience Improvements
β Smart Workspace File Search
- Intelligent path resolution: Automatically searches your project workspace
- Common directory support: Finds files in
data/,measurements/,test_data/,examples/,samples/ - Case-insensitive matching:
"DATA.MF4"finds"data.mf4" - Multiple path formats: Supports filenames, relative paths, and absolute paths
π οΈ Cross-Platform Compatibility
- Works on all platforms: Windows, macOS, Linux
- Proper path handling: Uses
pathlib.Pathfor OS-specific separators - Workspace-focused: No dependency on user-specific folders
π Enhanced Error Messages
- Helpful file suggestions: Shows available MDF files when target not found
- Clear workspace context: Displays current directory and searched locations
- Actionable tips: Guides users on file placement and path usage
π Improved Documentation
- uvx path troubleshooting: Clear instructions for "command not found" errors
- File organization guide: Best practices for workspace structure
- Cross-platform setup: Instructions for Windows, macOS, and Linux
π Usage Examples
The server now intelligently finds MDF files with any of these approaches:
# Just the filename - searches workspace automatically
"vehicle_data.mf4"
# Relative path from current directory
"./data/measurements.mf4"
# Absolute path - always works
"/full/path/to/file.mf4"
# Case doesn't matter
"TEST_DATA.MF4" β finds "test_data.mf4"ποΈ Recommended Workspace Structure
your-project/
βββ data.mf4 # β
Found automatically
βββ data/
β βββ test.mf4 # β
Found automatically
βββ measurements/
β βββ run1.mf4 # β
Found automatically
βββ test_data/
βββ examples/
βββ samples/
π Installation
uvx mcp-server-mdfTroubleshooting: If you get "command not found", find your uvx path:
which uvx # macOS/Linux
where uvx # WindowsCompatible IDEs: VS Code (Continue.dev), Cursor, Windsurf, and other MCP-enabled environments.
This release significantly reduces the friction of specifying file paths, making the MCP server much more user-friendly for daily development workflows.