MCP Aseps — Modular Multi-Server Suite

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.

Related MCP server: VegaMCP

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

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)

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

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 — arsitektur & data flow

• MEMORY.md — konsep dan penggunaan memory

• KNOWLEDGE.md — workspace RAG

• SKILLS.md — skill registry / procedural memory

• SECURITY.md — keamanan & credentials

• DEPLOYMENT.md — deployment & editor integration

• ROADMAP.md — rencana pengembangan

• TASKS.md — daftar tugas & status

Lisensi

MIT — lihat LICENSE untuk detail lengkap.