Skip to content
Back to search

noa-cockpit-mcp

Modular Model Context Protocol (MCP) server connecting AI agents to Obsidian second brain and local workflows

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/newgamer62--noa-cockpit-mcp/badge.svg)](/listings/newgamer62--noa-cockpit-mcp)

HTML

<a href="/listings/newgamer62--noa-cockpit-mcp"><img src="/api/listings/newgamer62--noa-cockpit-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

# Installer les dépendances
npm install

# Compiler le projet TypeScript
npm run build

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

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

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 128 lines
  1. # noa-cockpit-mcp 🎛️
  2. [![CI](https://github.com/NewGamer62/noa-cockpit-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/NewGamer62/noa-cockpit-mcp/actions/workflows/ci.yml)
  3. [![Release](https://img.shields.io/github/v/release/NewGamer62/noa-cockpit-mcp?style=flat-square&color=blueviolet)](https://github.com/NewGamer62/noa-cockpit-mcp/releases)
  4. [![Node.js Version](https://img.shields.io/badge/Node.js-v22%20--%20v24-339933?style=flat-square&logo=node.js)](https://nodejs.org)
  5. [![TypeScript](https://img.shields.io/badge/TypeScript-5.7+-3178C6?style=flat-square&logo=typescript)](https://www.typescriptlang.org)
  6. [![MCP Protocol](https://img.shields.io/badge/MCP-v1.1+-blueviolet?style=flat-square)](https://modelcontextprotocol.io)
  7. [![Health Score](https://img.shields.io/badge/Repo--Doctor-100%2F100%20(A%2B)-success?style=flat-square)](https://github.com/NewGamer62/repo-doctor)
  8. [![License](https://img.shields.io/badge/License-MIT-blue?style=flat-square)](LICENSE)
  9. > **Modular Model Context Protocol (MCP) Server connecting AI Agents (Antigravity, Cursor, Claude Code) to Noa's Obsidian Second Brain, Git diagnostics, PII privacy guards, and local developer workflows.**
  10. ---
  11. ## ⚡ Preview
  12. ```json
  13. // JSON-RPC Request (stdio)
  14. {
  15. "jsonrpc": "2.0",
  16. "id": 1,
  17. "method": "tools/call",
  18. "params": {
  19. "name": "privacy_guard_scan",
  20. "arguments": { "repo_path": "." }
  21. }
  22. }
  23. // JSON-RPC Response
  24. {
  25. "jsonrpc": "2.0",
  26. "id": 1,
  27. "result": {
  28. "content": [{
  29. "type": "text",
  30. "text": "{\n \"clean\": true,\n \"repo_path\": \"C:\\\\Users\\\\...\\\\noa-cockpit-mcp\",\n \"scanned_files_count\": 20,\n \"violations_count\": 0,\n \"violations\": []\n}"
  31. }]
  32. }
  33. }
  34. ```
  35. ---
  36. ## 🎯 Architecture & Modules
  37. `noa-cockpit-mcp` implémente le standard ouvert **Model Context Protocol (MCP)** en transport `stdio`.
  38. L'architecture est découpée en **3 modules indépendants** :
  39. ```mermaid
  40. flowchart TD
  41. Agent["🤖 Agent IA (Antigravity, Cursor, Claude Code)"] <-->|"stdio (JSON-RPC 2.0)"| Server["noa-cockpit-mcp"]
  42. subgraph Modules["Modules Métier"]
  43. Server <--> M1["Module 1 : Obsidian Brain"]
  44. Server <--> M2["Module 2 : Système & Dev Tooling"]
  45. Server <--> M3["Module 3 : Workflow & Privacy"]
  46. end
  47. M1 --> Security["assertSafeVaultPath (Security Jail)"]
  48. Security --> Vault["📂 Obsidian Vault"]
  49. M2 --> Ports["Ports & Zombie Process Killer"]
  50. M2 --> RepoDoc["repo-doctor Bridge"]
  51. M3 --> Privacy["poucave-pas-tout (PII & Secret Scanner)"]
  52. M3 --> Branches["Git Branch Cleaner"]
  53. M3 --> Dash["Dashboard & Morning Briefing Bridge"]
  54. ```
  55. ### 🛡️ Sécurité & Garde-Fous
  56. 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`.
  57. 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.).
  58. 3. **Anti-Leak PII & Confidentialité :** Le scanner de confidentialité inspecte les chemins machine en dur (`C:\Users\...`), les numéros de téléphone et les fichiers sensibles avant tout commit ou push.
  59. ---
  60. ## 🛠️ Les 11 Outils MCP Disponibles
  61. ### Module 1 : Obsidian Brain (Tranche 1)
  62. | Outil MCP | Description | Paramètres Clés |
  63. | :--- | :--- | :--- |
  64. | `obsidian_search_notes` | Recherche filtrée par texte, tag et pôle thématique | `query`, `tag`, `pole`, `limit` |
  65. | `obsidian_read_note` | Lecture complète avec parsing du Frontmatter YAML | `relative_path` |
  66. | `obsidian_append_journal` | Insertion déterministe d'un bilan quotidien antéchronologique | `date`, `subtitle`, `success_bullets`, `improvements_bullets` |
  67. | `obsidian_add_backlog_task` | Ajout d'une tâche cochable dans Backlog.md par priorité/domaine | `priority (P1/P2/P3)`, `domain`, `task` |
  68. | `obsidian_get_moc` | Extraction des notes liées depuis l'un des 7 Hubs/MOCs | `moc (Index-Projets, Index-Stack, ...)` |
  69. ### Module 2 : Système & Dev Tooling (Tranche 2)
  70. | Outil MCP | Description | Paramètres Clés |
  71. | :--- | :--- | :--- |
  72. | `system_inspect_port` | Inspecte le PID et le nom du processus écoutant sur un port TCP | `port (1-65535)` |
  73. | `system_free_port` | Tue le processus occupant un port (avec protection système) | `port`, `force (boolean)` |
  74. | `git_health_audit` | Déclenche un audit de santé complet d'un repo via `repo-doctor` | `repo_path`, `min_score (0-100)` |
  75. ### Module 3 : Workflow, Privacy & Git Hygiene (Tranche 3)
  76. | Outil MCP | Description | Paramètres Clés |
  77. | :--- | :--- | :--- |
  78. | `privacy_guard_scan` | Audite un dépôt pour interdire les fuites de chemins machine, PII et secrets (`poucave-pas-tout`) | `repo_path`, `staged_only (boolean)` |
  79. | `git_cleanup_branches` | Détecte et supprime en toute sécurité les branches locales déjà mergées dans master/main | `repo_path`, `dry_run (boolean)`, `base_branch` |
  80. | `dashboard_get_briefing` | Récupère le briefing matinal, les 3 priorités du jour et l'état du serveur local (port 5050) | `custom_dir (optional)` |
  81. ---
  82. ## 🚀 Démarrage Rapide
  83. ### Prérequis
  84. - [Node.js v22+](https://nodejs.org) (Node 24 recommandé).
  85. - `repo-doctor` compilé sur le système (optionnel pour l'audit Git).
  86. ### Installation & Compilation
  87. ```bash
  88. # Installer les dépendances
  89. npm install
  90. # Compiler le projet TypeScript
  91. npm run build
  92. # Lancer la suite complète de 27 tests unitaires
  93. npm test
  94. # Démarrer le serveur en écoute stdio
  95. npm start
  96. ```
  97. ---
  98. ## 📄 Licence
  99. Sous licence [MIT](LICENSE). Conçu par [Noa (NewGamer62)](https://github.com/NewGamer62).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.