mini_mcp

mini_mcp

mini_mcp é um plugin leve construído com FastMCP que recupera a lista de todos os arquivos localizados na área de trabalho do usuário atual do macOS.

📦 Instalação

Recomenda-se usar o Conda para criar um ambiente isolado:

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

Se você quiser instalar com o arquivo requirements.txt, instale as dependências com:

pip install -r requirements.txt

⚙️ Configuração do MCP

Para invocar a ferramenta list_desktop_files a partir de um cliente MCP externo, use a seguinte configuração:

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

⚠️ Certifique-se de atualizar os caminhos para corresponder ao seu interpretador Python local e à localização do projeto.

🛠 Descrição da Ferramenta

list_desktop_files()

• Objetivo: Lista todos os arquivos e pastas na área de trabalho do usuário atual.

• Plataforma: somente macOS

• Retorna: Uma lista de strings, cada uma representando um nome de arquivo ou pasta.

Exemplo de saída

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

📁 Estrutura do Projeto

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

🔒 Notas

• Esta ferramenta é implementada especificamente para macOS devido ao uso do caminho ~/Desktop.

• Para adaptar esta ferramenta para Windows ou Linux, modifique o caminho da área de trabalho de acordo no script main.py.

• Certifique-se de que fastmcp esteja instalado e seja compatível com a sua versão do Python.

🧩 Licença

Este projeto é fornecido como está, sem qualquer garantia. Para termos de licenciamento, consulte a licença do FastMCP, se aplicável.