Skip to main content
Glama

noa-cockpit-mcp 🎛️

Node.js Version TypeScript MCP Protocol Tests License

Modular Model Context Protocol (MCP) Server connecting AI Agents (Antigravity, Cursor, Claude Code) to Noa's Obsidian Second Brain, Git diagnostics, and local developer workflows.


⚡ Preview

// JSON-RPC Request (stdio)
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "system_inspect_port",
    "arguments": { "port": 3000 }
  }
}

// JSON-RPC Response
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [{
      "type": "text",
      "text": "{\n  \"port\": 3000,\n  \"occupied\": true,\n  \"pid\": 14208,\n  \"processName\": \"node.exe\",\n  \"state\": \"LISTENING\",\n  \"localAddress\": \"0.0.0.0:3000\"\n}"
    }]
  }
}

Related MCP server: Obsidian MCP Server

🎯 Architecture & Modules

noa-cockpit-mcp implémente le standard ouvert Model Context Protocol (MCP) en transport stdio.
L'architecture est découpée en modules indépendants :

flowchart LR
    Agent["🤖 Agent IA (Antigravity)"] <-->|"stdio (JSON-RPC 2.0)"| Server["noa-cockpit-mcp"]
    
    subgraph Modules["Modules Métier"]
        Server <--> M1["Module Obsidian Brain"]
        Server <--> M2["Module Système & Dev Tooling"]
    end
    
    M1 --> Security["assertSafeVaultPath (Security Jail)"]
    Security --> Vault["📂 Obsidian Vault"]
    
    M2 --> Ports["Ports & Zombie Process Killer"]
    M2 --> RepoDoc["repo-doctor Bridge"]

🛡️ Sécurité & Garde-Fous

  1. Sandbox Vault Jail : Toute tentative d'accès en dehors du coffre Obsidian (../../Desktop, C:\Windows, null bytes) est interceptée par une SecurityError.

  2. Protection Processus Système : Le tueur de ports refuse catégoriquement d'interrompre les processus système critiques (PIDs 0 et 4, svchost.exe, explorer.exe, csrss.exe, services.exe, etc.).


🛠️ Les 8 Outils MCP Disponibles

Module 1 : Obsidian Brain

Outil MCP

Description

Paramètres Clés

obsidian_search_notes

Recherche filtrée par texte, tag et pôle thématique

query, tag, pole, limit

obsidian_read_note

Lecture complète avec parsing du Frontmatter YAML

relative_path

obsidian_append_journal

Insertion déterministe d'un bilan quotidien antéchronologique

date, subtitle, success_bullets, improvements_bullets

obsidian_add_backlog_task

Ajout d'une tâche cochable dans Backlog.md par priorité/domaine

priority (P1/P2/P3), domain, task

obsidian_get_moc

Extraction des notes liées depuis l'un des 7 Hubs/MOCs

moc (Index-Projets, Index-Stack, ...)

Module 2 : Système & Dev Tooling

Outil MCP

Description

Paramètres Clés

system_inspect_port

Inspecte le PID et le nom du processus écoutant sur un port TCP

port (1-65535)

system_free_port

Tue le processus occupant un port (avec protection système)

port, force (boolean)

git_health_audit

Déclenche un audit de santé complet d'un repo via repo-doctor

repo_path, min_score (0-100)


🚀 Démarrage Rapide

Prérequis

  • Node.js v22+ (Node 24 recommandé).

  • repo-doctor compilé sur le système (optionnel pour l'audit Git).

Installation & Compilation

# Installer les dépendances
npm install

# Compiler le projet TypeScript
npm run build

# Lancer la suite complète de 20 tests unitaires
npm test

# Démarrer le serveur en écoute stdio
npm start

📄 Licence

Sous licence MIT. Conçu par Noa (NewGamer62).

Available Tools

8 tools
git_health_auditA

Déclenche un audit de santé et d'hygiène complet d'un dépôt Git local via repo-doctor (score 0-100, grade, piliers et remédiations)

Inputs: repo_path (required), min_score.

obsidian_add_backlog_taskA

Ajoute une action à cocher dans 03 - Vie Perso/Backlog.md sous le niveau de priorité et le domaine choisis

Inputs: task (required), domain (required), priority (required).

obsidian_append_journalA

Insère une entrée quotidienne structurée dans 03 - Vie Perso/Journal de Bilan.md en tête de l'historique

Inputs: date (required), subtitle (required), success_bullets (required), priorities_bullets, +1 more.

obsidian_get_mocB

Extrait les notes interconnectées depuis l'un des 7 Hubs/MOCs du coffre

Inputs: moc (required).

obsidian_read_noteB

Lit et extrait le contenu complet d'une note Obsidian avec séparation du frontmatter YAML

Inputs: relative_path (required).

obsidian_search_notesC

Recherche ciblée et filtrée à travers les notes du coffre Obsidian de Noa

Inputs: tag, pole, limit, query.

system_free_portB

Arrête proprement le processus bloquant un port TCP local (avec garde-fou de sécurité protégeant les processus système vitaux)

Inputs: port (required), force.

system_inspect_portB

Inspecte quel processus (PID et nom) écoute sur un port TCP local donné

Inputs: port (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables AI assistants to read, write, search, and navigate Obsidian vault notes with support for CRUD operations, full-text search, graph navigation, daily notes, and frontmatter management.
      3,713 npm
      -
    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      Provides AI agents with comprehensive access to Obsidian vaults, enabling reading, writing, searching, tagging, linking, canvas manipulation, and semantic search through 41 tools.
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to use Obsidian vaults as persistent, bidirectional knowledge workspaces with wikilink/backlink resolution, structured frontmatter/tag indexing, task aggregation, and Obsidian Headless Sync.
      11
      MIT