mini_mcp

by tinyzqh

Not rated
GitHub

About

A lightweight plugin to list all files and folders on the current macOS user's desktop.

Details

Author
tinyzqh
Categories
File Management, Other, Productivity

Setup

Install mini_mcp in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/tinyzqh/mini_mcp

Follow the installation instructions in the repository README, then restart your MCP client.

mini_mcpis a lightweight plugin built withFastMCPthat retrieves the list of all files located on the current macOS user's desktop.

It is recommended to use Conda to create an isolated environment:

conda create -n mcp python=3.12 conda activate mcp pip install fastmcp

If you want to install with the requirements.txt file, install dependencies with:

To invoke the list_desktop_files tool from an external MCP client, use the following configuration:

{ "mcpServers": { "list_desktop_files": { "command": "/Users/hzq/anaconda/anaconda3/envs/mcp/bin/python", "args": [ "/Users/hzq/py_projects/mini_mcp/main.py" ] } } }

⚠️ Make sure to update the paths to match your local Python interpreter and project location.

-

Purpose: Lists all files and folders on the current user's desktop.

Returns: A list of strings, each representing a file or folder name.

[ "report.pdf", "screenshot.png", "MyFolder" ]
mini_mcp/ ├── main.py # Main script that registers the FastMCP tool ├── README.md # This documentation file └── requirements.txt # (Optional) Dependency definitions

-

This tool is implemented specifically formacOSdue to the use of the~/Desktoppath.

To adapt this tool for Windows or Linux, modify the desktop path accordingly in themain.pyscript.

Ensure thatfastmcpis installed and compatible with your Python version.

This project is provided as-is without any warranty. For licensing terms, refer to FastMCP’s license if applicable.

Organize files in your Downloads folder using Cursor IDE with customizable rules.

Visualize directory structures with real-time updates, configurable depth, and smart exclusions for efficient project navigation.

A universal file download assistant supporting secure and batch processing of any file type.

Fast local full-text search for Windows files — names, contents, and OCR'd screenshot text; read-only MCP tools.

The fastest and the most accurate file search toolkit for AI agents

A server for programmatic exploration of local files and folders.

A simple utility to combine multiple files into a single file.

A server for local folder operations and file system access.

Provides essential utility tools for text processing, file operations, and system tasks.

An MCP server for local file management and system operations.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.