noa-cockpit-mcp
Provides a Git repository health audit tool that runs a full audit via repo-doctor for a given repository path, with an optional minimum score threshold.
Provides tools for interacting with an Obsidian vault, including searching notes by text, tag, and thematic pole; reading notes with YAML frontmatter parsing; appending daily journal entries; adding backlog tasks by priority and domain; and extracting linked notes from MOCs.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@noa-cockpit-mcp What's using port 3000? Free it if it's a zombie node process."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
noa-cockpit-mcp 🎛️
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
Sandbox Vault Jail : Toute tentative d'accès en dehors du coffre Obsidian (
../../Desktop,C:\Windows, null bytes) est interceptée par uneSecurityError.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 |
| Recherche filtrée par texte, tag et pôle thématique |
|
| Lecture complète avec parsing du Frontmatter YAML |
|
| Insertion déterministe d'un bilan quotidien antéchronologique |
|
| Ajout d'une tâche cochable dans Backlog.md par priorité/domaine |
|
| Extraction des notes liées depuis l'un des 7 Hubs/MOCs |
|
Module 2 : Système & Dev Tooling
Outil MCP | Description | Paramètres Clés |
| Inspecte le PID et le nom du processus écoutant sur un port TCP |
|
| Tue le processus occupant un port (avec protection système) |
|
| Déclenche un audit de santé complet d'un repo via |
|
🚀 Démarrage Rapide
Prérequis
Node.js v22+ (Node 24 recommandé).
repo-doctorcompilé 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 toolsgit_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
Persistent memory and knowledge management for AI agents with semantic search and 50+ tools.
YouTube transcripts, IMDb search and podcast search as agent tools.
Agent-native notes, tasks, dev-docs, vaults, sync & handoffs. MCP + OpenAPI dual surface.
Persistent memory, hybrid search and a goal graph for AI agents, over stdio or remote HTTP.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceEnables 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-
- AlicenseBqualityDmaintenanceEnables AI assistants to search, create, and manage notes in an Obsidian vault via 40+ local tools.5221 npmMIT
- -licenseNot gradedqualityNot gradedmaintenanceProvides AI agents with comprehensive access to Obsidian vaults, enabling reading, writing, searching, tagging, linking, canvas manipulation, and semantic search through 41 tools.-
- AlicenseAqualityCmaintenanceEnables 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.11MIT