MCP Server
MCP - Model Context Protocol
A conversational application server that integrates LLM capabilities via Ollama with vector memory context, supporting multiple users, sessions, automatic history summarization, and a plugin system for executing real actions.
0
GitHub Stars
11/17/2025
Last Updated
No Configuration
Please check the documentation below.
README Documentation
đ§ MCP - Model Context Protocol
Projeto completo para uma aplicação conversacional com:
- â FastAPI + JWT
- â LLM local via Ollama (ex: Mistral)
- â Contexto com memĂłria vetorial (ChromaDB)
- â Suporte a mĂșltiplos usuĂĄrios e sessĂ”es
- â Resumo automĂĄtico de histĂłrico longo
- â Sistema de plugins para executar açÔes reais
đ Como rodar
1. Clone o projeto e crie o ambiente
git clone <repo>
cd mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
2. Configure o .env
MODEL_NAME=mistral
VECTOR_DB_PATH=./chroma
DB_PATH=./mcp.db
CONTEXT_LIMIT=5
SUMMARY_TRIGGER=20
3. Inicie o Ollama
ollama run mistral
4. Suba o servidor
chmod +x start.sh
./start.sh
đĄïž Autenticação
-
POST /auth/register: Cria novo usuĂĄrio
-
POST /auth/login: Retorna token JWT
Use o token JWT nas requisiçÔes para /mcp/chat.
đ€ Plugins
Para chamar um plugin:
{
"session_id": "sessao01",
"prompt": "plugin: {\"name\": \"list_files\", \"args\": {\"path\": \"/etc\"}}"
}
đ Estrutura
app/
âââ routes/ # Rotas da API
âââ services/ # LĂłgica de negĂłcio (MCP, plugins, memĂłria)
âââ db/ # PersistĂȘncia (SQLite e vetorial)
âââ models/ # Schemas Pydantic
âââ plugins/ # Plugins executĂĄveis pelo MCP
âââ auth/ # Login, JWT, usuĂĄrios
đŹ Contato
Desenvolvido por [Everson đ§ ].
Quick Actions
Key Features
Model Context Protocol
Secure Communication
Real-time Updates
Open Source