# MCP Aseps — Modular Multi-Server Suite

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
[![Code style: ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)

Agnostik, modular MCP (Model Context Protocol) server suite untuk agent yang berbasis memori, pengetahuan, skill, dan integrasi eksternal. Dirancang untuk efisiensi token, local-first storage, dan mudah di-deploy di berbagai editor (Claude Desktop, Cline, Cursor, dll).

## Fitur Utama

- **servers/orchestrator** — MAF (Master Agentic Framework) Orchestrator untuk routing dan manajemen eksekusi agent.
- **servers/decision** — SemIf (JEV-CPU) Decision Layer untuk triage, risk assessment, dan decision routing.
- **servers/core** — filesystem, shell, system, web, dan security tools (OMP Runtime).
- **servers/memory** — long-term memory (LTM) & **Hindsight Engine** dengan SQLite + sqlite-vec + FTS5 + Ollama embeddings.
- **servers/knowledge** — workspace RAG: indexing file teks, chunking, hybrid semantic + keyword search.
- **servers/document** — Document extraction, OCR vision text rendering, dan PDF processing.
- **servers/skills** — procedural memory / skill registry dengan semantic recall.
- **servers/bridge** — integrasi sistem eksternal: Gmail, Telegram, Gemini, Vision, MikroTik RouterOS (credential dari `.env`).
- **shared/** — konfigurasi terpusat, embedding client, Redis cache, model, logging, security.
- **config/** — konfigurasi editor universal (`mcp_universal.json`, `claude_desktop_config.json`, `cline_mcp_settings.json`).
- **scripts/** — `start-all.sh`, `stop-all.sh`, `backup.sh`, `start-omp.sh`, `setup-vscode.sh`.

## Prasyarat

- Python 3.12+
- Ollama (untuk embedding) — default `http://localhost:11434`, model `nomic-embed-text`
- Redis opsional — untuk embedding cache dan working memory
- Docker + docker-compose opsional — untuk menjalankan Ollama & Redis

## Instalasi Cepat

```bash
git clone https://github.com/asepsafrudin/multiple-mcp-server-by-kimi.git /home/aseps/MCP
cd /home/aseps/MCP
cp .env.example .env
# edit .env sesuai environment Anda
make install
```

## Menjalankan Server

### Mode SSE (background, untuk testing/remote)

```bash
make start
# Akses endpoint: http://127.0.0.1:8000/sse (core), 8001 (memory), dst.
make stop
```

### Mode stdio (untuk integrasi editor)

Gunakan file konfigurasi di `config/`:
- `config/claude_desktop_config.json`
- `config/cline_mcp_settings.json`
- `config/mcp_universal.json`

Salin konfigurasi yang sesuai ke editor Anda.

## Struktur Direktori

```
.
├── config/              # konfigurasi editor & universal
├── data/                # SQLite databases (memory_v2.db, knowledge_v2.db, skills_v2.db)
├── servers/
│   ├── orchestrator/    # MAF Orchestrator (Tugas / Routing)
│   ├── decision/        # SemIf (JEV-CPU) Decision layer
│   ├── core/
│   ├── memory/          # Memory (LTM) & Hindsight Engine
│   ├── knowledge/
│   ├── document/        # Document & PDF OCR extraction
│   ├── skills/
│   └── bridge/
├── shared/              # library bersama
├── scripts/             # start-all, stop-all, backup, OMP & vscode scripts
├── tasks/               # daftar tugas dan progress implementasi
├── tests/               # pytest suite
├── workspace/           # symlink bekerja (sandboxing environment)
├── docker-compose.yml
├── Makefile
├── pyproject.toml
└── .env.example
```

## Perintah Makefile

```bash
make install   # buat venv & install editable + dev deps
make dev       # install editable
make test      # jalankan pytest
make lint      # ruff check
make format    # ruff format & auto-fix
make clean     # bersihkan cache
make start     # start semua server SSE
make stop      # stop semua server
make backup    # backup SQLite databases
```

## CI/CD Status

GitHub Actions workflows aktif di repo ini:
- **`ci.yml`** — menjalankan pytest + ruff + mypy pada setiap push ke `main` dan setiap PR
- **`lint.yml`** — fast lane: hanya ruff (untuk feedback cepat)
- **`typecheck.yml`** — slow lane: mypy --strict harian (nightly cron)

## Dokumentasi Detail

- [ARCHITECTURE.md](ARCHITECTURE.md) — arsitektur & data flow
- [MEMORY.md](MEMORY.md) — konsep dan penggunaan memory
- [KNOWLEDGE.md](KNOWLEDGE.md) — workspace RAG
- [SKILLS.md](SKILLS.md) — skill registry / procedural memory
- [SECURITY.md](SECURITY.md) — keamanan & credentials
- [DEPLOYMENT.md](DEPLOYMENT.md) — deployment & editor integration
- [ROADMAP.md](ROADMAP.md) — rencana pengembangan
- [TASKS.md](TASKS.md) — daftar tugas & status

## Lisensi

MIT — lihat [LICENSE](LICENSE) untuk detail lengkap.