Skip to content

v0.1.2: Improved file path handling & user experience

Choose a tag to compare

@Shanko-26 Shanko-26 released this 25 Jul 05:40
· 2 commits to master since this release

πŸš€ 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.Path for 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-mdf

Troubleshooting: If you get "command not found", find your uvx path:

which uvx  # macOS/Linux
where uvx  # Windows

Compatible 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.