mini_mcp

mini_mcp

mini_mcp es un plugin ligero construido con FastMCP que recupera la lista de todos los archivos ubicados en el escritorio del usuario actual de macOS.

📦 Instalación

Se recomienda usar Conda para crear un entorno aislado:

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

Si deseas instalar con el archivo requirements.txt, instala las dependencias con:

pip install -r requirements.txt

⚙️ Configuración de MCP

Para invocar la herramienta list_desktop_files desde un cliente MCP externo, usa la siguiente configuración:

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

⚠️ Asegúrate de actualizar las rutas para que coincidan con tu intérprete de Python local y la ubicación del proyecto.

🛠 Descripción de la Herramienta

list_desktop_files()

• Propósito: Lista todos los archivos y carpetas en el escritorio del usuario actual.

• Plataforma: solo macOS

• Devuelve: Una lista de cadenas, cada una representando un nombre de archivo o carpeta.

Ejemplo de salida

[
  "report.pdf",
  "screenshot.png",
  "MyFolder"
]

📁 Estructura del Proyecto

mini_mcp/
├── main.py          # Main script that registers the FastMCP tool
├── README.md        # This documentation file
└── requirements.txt # (Optional) Dependency definitions

🔒 Notas

• Esta herramienta está implementada específicamente para macOS debido al uso de la ruta ~/Desktop.

• Para adaptar esta herramienta para Windows o Linux, modifica la ruta del escritorio en consecuencia en el script main.py.

• Asegúrate de que fastmcp esté instalado y sea compatible con tu versión de Python.

🧩 Licencia

Este proyecto se proporciona tal cual, sin ninguna garantía. Para los términos de licencia, consulta la licencia de FastMCP si corresponde.