Skip to main content
Glama

Personal MCP Server

by pablicio
GitHub
Python
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

🎯 MCP SERVER PESSOAL v1.0.0

Servidor MCP extensível para uso pessoal com Claude Desktop

🚀 Início Rápido (30 segundos)

# 1. Execute o menu interativo run_tests.bat # 2. Escolha [1] para testar # 3. Escolha [2] para iniciar # 4. Abra Claude Desktop e teste!

🎉 Pronto! Agora você pode usar comandos como:

  • "liste minhas tarefas"

  • "crie uma nota sobre Python"

  • "liste arquivos em C:\projetos"

📚 Documentação

✨ Funcionalidades

📋 Gerenciamento de Tarefas

  • Criar, listar, completar e deletar tarefas

  • Buscar tarefas por texto

  • Filtrar por status (pendente/concluída)

  • Definir prioridades e datas limite

📝 Sistema de Notas

  • Criar notas com tags

  • Listar notas recentes

  • Organização simples e eficiente

📁 Acesso a Arquivos

  • Ler e escrever arquivos

  • Listar diretórios

  • Buscar arquivos

  • Controle de permissões

📅 Calendário Google (Opcional)

  • Criar eventos

  • Listar próximos eventos

  • Integração OAuth2

🛠️ Ferramentas Disponíveis

Menu Interativo (run_tests.bat)

╔══════════════════════════════════════════════════════════════════╗ ║ MCP SERVER PESSOAL - MENU DE TESTE E EXECUÇÃO ║ ╚══════════════════════════════════════════════════════════════════╝ [1] 🧪 Testar Servidor → Verifica funcionamento [2] 🚀 Iniciar Servidor → Modo com feedback visual [3] 📊 Monitor Real-time → Dashboard de atividade [4] 📝 Ver Logs → Logs em tempo real [5] 🔍 Ver Status → Status atual do servidor [6] 🧹 Limpar Logs → Remove arquivos de log [7] ❌ Sair

Scripts Individuais

Script

Descrição

test_connection.py

Executa bateria de testes completa

main_verbose.py

Servidor com feedback detalhado

monitor.py

Monitor visual em tempo real

main.py

Servidor normal (produção)

📊 Como Verificar se Está Funcionando

Método 1: Testes Automáticos (Recomendado)

run_tests.bat → [1] Testar Servidor

Resultado esperado:

✅ INITIALIZATION PASSOU ✅ MODULES PASSOU ✅ TASKS PASSOU ✅ FILESYSTEM PASSOU ✅ TOOLS PASSOU 🎉 TODOS OS TESTES PASSARAM!

Método 2: Monitor Visual

run_tests.bat → [3] Monitor em Tempo Real

Mostra:

  • Status do servidor (rodando/parado)

  • Estatísticas de logs

  • Contador de tarefas

  • Últimas linhas do log

Método 3: Teste no Claude Desktop

  1. Inicie o servidor: run_tests.bat → [2]

  2. Abra Claude Desktop

  3. Digite: "liste minhas tarefas"

  4. Se funcionar, está conectado! ✅

🔧 Configuração

Arquivo .env

# Debug DEBUG=False # Diretórios permitidos (separados por vírgula) ALLOWED_DIRECTORIES="C:\projetos\IA,C:\Users\PC Gamer\Documents" # Logs LOG_LEVEL=INFO LOG_FILE=./logs/mcp_server.log # Tarefas TASKS_DB_PATH=./data/tasks.json # Google Calendar (opcional) GOOGLE_CLIENT_ID=seu_client_id GOOGLE_CLIENT_SECRET=seu_secret

Configuração no Claude Desktop

Arquivo: %APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "personal-server": { "command": "C:\\projetos\\IA\\mcp\\mcp-tools2\\venv\\Scripts\\python.exe", "args": ["C:\\projetos\\IA\\mcp\\mcp-tools2\\main.py"] } } }

🐛 Solução de Problemas

❌ Servidor não inicia

# 1. Verifique dependências venv\Scripts\activate pip install -r requirements.txt # 2. Teste com modo verbose python main_verbose.py # 3. Veja os logs type logs\mcp_server.log

❌ Claude não reconhece os comandos

  1. Reinicie Claude Desktop completamente

  2. Verifique configuração: %APPDATA%\Claude\claude_desktop_config.json

  3. Monitore logs: run_tests.bat → [4]

  4. Execute testes: run_tests.bat → [1]

❌ Testes falharam

# 1. Ative debug echo DEBUG=True >> .env # 2. Execute testes novamente python test_connection.py # 3. Veja erros detalhados nos logs

📦 Estrutura do Projeto

mcp-tools2/ ├── 📄 README.md ⭐ Este arquivo ├── 📄 QUICKSTART_VISUAL.md 🚀 Guia visual rápido ├── 📄 GUIA_TESTES.md 🧪 Como testar ├── 📄 COMO_USAR.md 📚 Documentação completa │ ├── 🎮 run_tests.bat ⭐ Menu principal ├── 🧪 test_connection.py Testes automáticos ├── 📊 monitor.py Monitor visual ├── 🚀 main_verbose.py Servidor com feedback ├── ⚙️ main.py Servidor normal │ ├── core/ Núcleo do servidor │ ├── server.py Servidor MCP principal │ └── registry.py Registro de ferramentas │ ├── modules/ Módulos funcionais │ ├── tasks/ Gerenciamento de tarefas │ ├── filesystem/ Acesso a arquivos │ └── calendar/ Integração com Google │ ├── config/ Configurações │ ├── settings.py Configurações globais │ └── logging.py Sistema de logs │ ├── logs/ Arquivos de log │ └── mcp_server.log Log principal │ └── data/ Dados persistentes └── tasks.json Banco de tarefas

🎯 Casos de Uso

Desenvolvimento

# Terminal 1: Servidor com feedback run_tests.bat → [2] # Terminal 2: Monitor de atividade run_tests.bat → [3] # Trabalhar normalmente no Claude Desktop

Produção (dia a dia)

# Iniciar servidor run_tests.bat → [2] # Usar Claude Desktop normalmente # O servidor roda em background

Debugging

# 1. Ativar debug echo DEBUG=True > .env # 2. Ver logs ao vivo run_tests.bat → [4] # 3. Usar Claude Desktop e ver o que acontece

📝 Comandos Exemplo no Claude

# Tarefas "crie uma tarefa: Estudar Python" "liste minhas tarefas pendentes" "complete a tarefa 1" "busque tarefas sobre Python" "delete a tarefa 2" # Notas "crie uma nota sobre MCP Server" "liste minhas últimas notas" # Arquivos "liste os arquivos em C:\projetos\IA" "leia o arquivo README.md" "crie um arquivo teste.txt com 'Hello World'" "busque arquivos .py no diretório"

🔄 Atualizações

v1.0.0 (2025-10-18)

  • ✅ Sistema de testes automáticos

  • ✅ Menu interativo (run_tests.bat)

  • ✅ Monitor visual em tempo real

  • ✅ Modo verbose com feedback

  • ✅ Documentação completa

  • ✅ Melhor tratamento de erros

  • ✅ Guias visuais (QUICKSTART_VISUAL.md, GUIA_TESTES.md)

🤝 Contribuindo

Este é um projeto pessoal, mas melhorias são bem-vindas!

  1. Faça fork do projeto

  2. Crie uma branch (git checkout -b feature/nova-funcionalidade)

  3. Commit suas mudanças (git commit -am 'Adiciona nova funcionalidade')

  4. Push para a branch (git push origin feature/nova-funcionalidade)

  5. Abra um Pull Request

📄 Licença

MIT License - use como quiser!

🆘 Precisa de Ajuda?

  1. Leia primeiro: QUICKSTART_VISUAL.md ⭐

  2. Testes: GUIA_TESTES.md

  3. Documentação: COMO_USAR.md

  4. Execute os testes: run_tests.bat → [1]

  5. Veja os logs: run_tests.bat → [4]

🎉 Pronto para Começar?

run_tests.bat

É só isso! O menu vai te guiar. 🚀

Desenvolvido com ❤️ para integração com Claude Desktop

Última atualização: 18/10/2025

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

A personal MCP server for Claude Desktop that enables task management, note-taking, file system operations, and optional Google Calendar integration. Includes comprehensive testing tools and visual monitoring for easy setup and debugging.

  1. 🚀 Início Rápido (30 segundos)
    1. 📚 Documentação
      1. ✨ Funcionalidades
        1. 📋 Gerenciamento de Tarefas
        2. 📝 Sistema de Notas
        3. 📁 Acesso a Arquivos
        4. 📅 Calendário Google (Opcional)
      2. 🛠️ Ferramentas Disponíveis
        1. Menu Interativo (run_tests.bat)
        2. Scripts Individuais
      3. 📊 Como Verificar se Está Funcionando
        1. Método 1: Testes Automáticos (Recomendado)
        2. Método 2: Monitor Visual
        3. Método 3: Teste no Claude Desktop
      4. 🔧 Configuração
        1. Arquivo .env
        2. Configuração no Claude Desktop
      5. 🐛 Solução de Problemas
        1. ❌ Servidor não inicia
        2. ❌ Claude não reconhece os comandos
        3. ❌ Testes falharam
      6. 📦 Estrutura do Projeto
        1. 🎯 Casos de Uso
          1. Desenvolvimento
          2. Produção (dia a dia)
          3. Debugging
        2. 📝 Comandos Exemplo no Claude
          1. 🔄 Atualizações
            1. v1.0.0 (2025-10-18)
          2. 🤝 Contribuindo
            1. 📄 Licença
              1. 🆘 Precisa de Ajuda?
                1. 🎉 Pronto para Começar?

                  New MCP Servers

                  MCP directory API

                  We provide all the information about MCP servers via our MCP API.

                  curl -X GET 'https://glama.ai/api/mcp/v1/servers/pablicio/my-mcp'

                  If you have feedback or need assistance with the MCP directory API, please join our Discord server