Personal MCP Server
Provides optional integration with Google Calendar API using OAuth2 authentication, enabling creation and listing of calendar events
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Personal MCP Serverliste minhas tarefas pendentes"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🎯 MCP SERVER PESSOAL v1.0.0
Servidor MCP extensível para uso pessoal com Claude Desktop
🚀 Início Rápido (30 segundos)
Opção 1: Interface Web (Recomendado)
# Execute a interface web
start_web_interface.bat
# Abra no navegador
http://localhost:5000Opção 2: Integração com Claude Desktop
# 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
WEB_INTERFACE.md - Interface Web Completa 🌐 ⭐
QUICKSTART_VISUAL.md - Guia visual rápido ⭐
GUIA_TESTES.md - Como testar e verificar conexão
COMO_USAR.md - Documentação completa
✨ Funcionalidades
🌐 Interface Web (NOVO!)
Dashboard em tempo real com estatísticas
Gerenciamento visual de tarefas
Criação de tarefas com formulário intuitivo
Logs do servidor ao vivo
Atualização automática a cada 5 segundos
Design moderno e responsivo
Acesse:
start_web_interface.bat→ http://localhost:5000
📋 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] ❌ SairScripts Individuais
Script | Descrição |
| Executa bateria de testes completa |
| Servidor com feedback detalhado |
| Monitor visual em tempo real |
| Servidor normal (produção) |
📊 Como Verificar se Está Funcionando
Método 1: Testes Automáticos (Recomendado)
run_tests.bat → [1] Testar ServidorResultado 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 RealMostra:
Status do servidor (rodando/parado)
Estatísticas de logs
Contador de tarefas
Últimas linhas do log
Método 3: Teste no Claude Desktop
Inicie o servidor:
run_tests.bat → [2]Abra Claude Desktop
Digite:
"liste minhas tarefas"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_secretConfiguraçã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
Reinicie Claude Desktop completamente
Verifique configuração:
%APPDATA%\Claude\claude_desktop_config.jsonMonitore logs:
run_tests.bat → [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 DesktopProdução (dia a dia)
# Iniciar servidor
run_tests.bat → [2]
# Usar Claude Desktop normalmente
# O servidor roda em backgroundDebugging
# 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!
Faça fork do projeto
Crie uma branch (
git checkout -b feature/nova-funcionalidade)Commit suas mudanças (
git commit -am 'Adiciona nova funcionalidade')Push para a branch (
git push origin feature/nova-funcionalidade)Abra um Pull Request
📄 Licença
MIT License - use como quiser!
🆘 Precisa de Ajuda?
Leia primeiro: QUICKSTART_VISUAL.md ⭐
Testes: GUIA_TESTES.md
Documentação: COMO_USAR.md
Execute os testes:
run_tests.bat → [1]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
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
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