text

Memory-IA MCP Server

Model Context Protocol (MCP) Server - Agente IA com Memória Persistente para VS Code, Gemini-CLI, Cursor e outras ferramentas.

🚀 Features

• Chat com Memória Persistente - Agente IA com contexto SQLite
• Ollama Integrado - Suporte a modelos locais (llama3.2, qwen, etc)
• JSON-RPC Protocol - Comunicação padronizada MCP
• Auto-Restart - Serviço systemd com restart automático
• Multi-Client - Funciona em VS Code, Gemini-CLI, terminal, etc

📋 Stack

• Python 3.12 com FastAPI
• LangGraph + LangChain para agentes
• SQLite para memória persistente
• Ollama para LLM local
• systemd para gerenciamento

🔧 Instalação

1. Clonar repositório

cd ~ git clone https://github.com/seu-usuario/memory-ia-mcp.git cd memory-ia-mcp

text

2. Criar ambiente virtual

python3 -m venv memorivenv source memorivenv/bin/activate

text

3. Instalar dependências

pip install -r requirements.txt

text

4. Executar MCP Server

./run_mcp.sh

text

🎯 Uso Rápido

Terminal

echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | python src/mcp_server.py

text

VS Code

1. Configuração em ~/.config/Code/User/mcp.json
2. Abra Command Palette: Ctrl+Shift+P
3. Procure por MCP: List Servers
4. Selecione memory-ia-agent

Gemini-CLI

gemini-cli --mcp-server /home/helcio/memory-ia-mcp/src/mcp_server.py

text

📡 Ferramentas Disponíveis

Tool	Descrição
memory_chat	Chat com memória persistente
run_ollama	Executar modelo Ollama direto
agent_health	Status do agente

🛠️ Serviço systemd

Status

sudo systemctl status memory-ia-mcp.service

text

Logs

sudo journalctl -u memory-ia-mcp -f

text

Controle

sudo systemctl restart memory-ia-mcp sudo systemctl stop memory-ia-mcp sudo systemctl start memory-ia-mcp

text

📂 Estrutura

memory-ia-mcp/ ├── src/ │ ├── mcp_server.py │ ├── agente_langgraph.py │ ├── agente_persistente.py │ └── api_agente.py ├── config/ │ └── mcp.json ├── docs/ │ └── DEVELOPMENT.md ├── tests/ │ └── test_mcp.py ├── run_mcp.sh ├── requirements.txt └── README.md

text

🔐 Configuração

Crie .env:

OLLAMA_URL=http://localhost:11434 AGENT_PORT=8000 DEBUG=False

text

📖 Documentação

• Desenvolvimento
• Model Context Protocol

🤝 Contribuições

Sinta-se livre para abrir issues e PRs!

---

Desenvolvido com ❤️
Última atualização: Nov 28, 2025