maifady-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Maifady
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.es.md

@@ -0,0 +1,244 @@
+<div align="center">
+
+# 🔌 Servidor MCP Maifady
+
+**30 agentes de IA especializados en ingeniería — para cualquier cliente compatible MCP**
+
+> 🌍 [English](README.md) · [Français](README.fr.md) · **[Español](README.es.md)** · [中文](README.zh-CN.md) · [日本語](README.ja.md)
+
+[![Licencia: MIT](https://img.shields.io/badge/Licencia-MIT-yellow.svg)](LICENSE)
+[![MCP](https://img.shields.io/badge/MCP-compatible-blueviolet)](https://modelcontextprotocol.io)
+[![npm](https://img.shields.io/badge/npm-maifady--mcp-red)](https://www.npmjs.com/package/maifady-mcp)
+[![Agentes](https://img.shields.io/badge/agentes-30-blue)](agents/)
+[![100% gratis](https://img.shields.io/badge/100%25-gratis-success)](#)
+
+[**Instalación**](#-instalación) · [**Clientes**](#-clientes-soportados) · [**Agentes**](#-los-30-agentes) · [**Funcionamiento**](#-cómo-funciona)
+
+</div>
+
+---
+
+## ⚡ ¿Qué es esto?
+
+**El servidor MCP Maifady** expone 30 agentes de ingeniería especializados a través del [Model Context Protocol](https://modelcontextprotocol.io) — el estándar abierto para conectar asistentes IA a herramientas. Instálalo una vez, usa los mismos 30 especialistas en:
+
+- 🎨 **Cursor**
+- 🖥️ **Claude Desktop**
+- 💻 **Cline** (extensión VS Code)
+- ⚡ **Zed**
+- 🔧 **Cualquier otro cliente MCP**
+
+Un código. Todos los clientes. Sin reinstalación por IDE.
+
+- ✅ **100% gratis** — licencia MIT, sin registro, sin telemetría, sin claves API
+- ✅ **100% local** — corre en tu máquina vía `npx` o instalación local
+- ✅ **30 especialistas** — code review, optimización SQL, auditoría de seguridad, refactoring, Docker, K8s, Terraform, etc.
+- ✅ **Nativo MCP** — transporte `stdio` estándar, compatible con [@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/typescript-sdk)
+
+---
+
+## 🚀 Instalación
+
+### Requisitos
+
+- **Node.js ≥ 18** (necesario para `npx maifady-mcp`)
+
+### Vía más rápida: `npx` (sin instalación)
+
+Los ejemplos de configuración a continuación usan todos `npx -y maifady-mcp`, que descarga y ejecuta la última versión en cada invocación. **Sin instalación global necesaria.**
+
+### O instalación global
+
+```bash
+npm install -g maifady-mcp
+```
+
+Luego refiérelo como `maifady-mcp` en tu config (en vez de `npx -y maifady-mcp`).
+
+---
+
+## 🛠 Clientes soportados
+
+### Cursor
+
+Guarda en `.cursor/mcp.json` (por proyecto) o `~/.cursor/mcp.json` (global):
+
+```json
+{
+  "mcpServers": {
+    "maifady": {
+      "command": "npx",
+      "args": ["-y", "maifady-mcp"]
+    }
+  }
+}
+```
+
+Abre Cursor → los 30 agentes aparecen como herramientas en el chat. Invócalos naturalmente:
+
+```
+Revisa esta consulta por cuellos de botella: SELECT * FROM orders WHERE ...
+```
+
+Cursor elegirá `maifady_sql_optimizer` automáticamente — o llamará a `maifady_list_agents` primero para ver lo disponible.
+
+### Claude Desktop
+
+Guarda en `claude_desktop_config.json`:
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+- **Linux**: `~/.config/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "maifady": {
+      "command": "npx",
+      "args": ["-y", "maifady-mcp"]
+    }
+  }
+}
+```
+
+Reinicia Claude Desktop. Los 30 agentes ya están disponibles — busca el icono 🔌 en la entrada del chat.
+
+### Cline (extensión VS Code)
+
+Abre el panel Cline → Settings → MCP Servers, o edita `cline_mcp_settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "maifady": {
+      "command": "npx",
+      "args": ["-y", "maifady-mcp"],
+      "disabled": false,
+      "autoApprove": []
+    }
+  }
+}
+```
+
+### Zed
+
+Edita `~/.config/zed/settings.json` (Linux/macOS) o `%APPDATA%\Zed\settings.json` (Windows):
+
+```json
+{
+  "context_servers": {
+    "maifady": {
+      "command": {
+        "path": "npx",
+        "args": ["-y", "maifady-mcp"]
+      }
+    }
+  }
+}
+```
+
+### Cualquier otro cliente MCP
+
+El servidor habla MCP estándar vía `stdio`. Cualquier cliente que soporte el protocolo puede usarlo — ver [modelcontextprotocol.io/clients](https://modelcontextprotocol.io/clients).
+
+---
+
+## 🎯 Uso
+
+Una vez conectado, tu cliente ve **31 herramientas**:
+
+| Herramienta | Propósito |
+|---|---|
+| `maifady_list_agents` | Descubrimiento — lista los 30 agentes con descripciones. Llámalo primero si tu cliente necesita ayuda para enrutar. |
+| `maifady_sql_optimizer` | Optimizar una consulta lenta |
+| `maifady_code_reviewer_pro` | Review de PR nivel principal engineer |
+| `maifady_security_auditor` | Auditoría de seguridad OWASP/ASVS |
+| `maifady_dockerfile_optimizer` | Reducir + endurecer un Dockerfile |
+| `maifady_terraform_writer` | Terraform production-grade |
+| `maifady_react_modernizer` | Migrar React legacy a hooks |
+| `maifady_accessibility_auditor` | Auditoría WCAG 2.2 AA |
+| `maifady_e2e_test_writer` | E2E fiables Playwright/Cypress |
+| `maifady_regex_explainer` | Decodificar + endurecer una regex |
+| ... | ... 22 especialistas más ... |
+
+Cada herramienta toma un solo parámetro `task` (string). El servidor devuelve el system prompt completo del agente alrededor de tu tarea — el LLM host adopta ese rol y produce la respuesta.
+
+### Ejemplos
+
+```
+Usa maifady_sql_optimizer para arreglar esta consulta: SELECT * FROM orders WHERE YEAR(created_at)=2024
+```
+
+```
+Ejecuta maifady_security_auditor en el flujo de auth en src/middleware/
+```
+
+O simplemente describe la tarea — la mayoría de clientes eligen la herramienta correcta automáticamente:
+
+```
+Este Dockerfile genera 1.2 GB. Hazlo más pequeño.
+```
+
+---
+
+## 🤖 Los 30 agentes
+
+| Categoría | Agentes |
+|---|---|
+| **Calidad de código** | `code-reviewer-lite`, `code-reviewer-pro`, `security-auditor`, `refactor-assistant`, `dead-code-finder`, `complexity-analyzer` |
+| **BD & Perf** | `sql-optimizer`, `schema-designer`, `migration-writer`, `perf-profiler` |
+| **Tests** | `test-generator`, `e2e-test-writer`, `coverage-improver` |
+| **Git & Docs** | `commit-message-writer`, `readme-generator`, `gitignore-generator`, `tech-writer`, `api-doc-generator` |
+| **Frontend** | `react-modernizer`, `accessibility-auditor`, `bundle-analyzer` |
+| **Backend & API** | `api-designer`, `openapi-generator`, `microservices-architect` |
+| **DevOps & Cloud** | `dockerfile-optimizer`, `kubernetes-yaml-writer`, `terraform-writer` |
+| **IA/ML & Utils** | `prompt-engineer`, `ml-pipeline-architect`, `regex-explainer` |
+
+El system prompt completo de cada agente está en `agents/<slug>.md`. Léelos — cada prompt está escrito para ser honesto sobre el alcance, empujar hacia atrás en lo prematuro, y producir resultados concretos.
+
+---
+
+## 🛠 Cómo funciona
+
+1. **Arranque**: el servidor lee cada `agents/*.md` y parsea frontmatter + body.
+2. **Registro**: cada agente se convierte en una herramienta MCP `maifady_<slug>` con su descripción.
+3. **Invocación**: cuando un cliente llama a una herramienta con `{ task: "..." }`, el servidor devuelve un payload de texto que contiene:
+   - El system prompt del agente
+   - La tarea del usuario
+   - Un recordatorio de mantenerse en el alcance
+4. **LLM host**: el LLM que llama (Claude, GPT-4, etc.) lee este payload y produce la respuesta **como ese especialista**.
+
+Este enfoque — «prompt injection vía resultado de herramienta» — significa que el servidor en sí nunca llama a una API IA. Sin claves API, sin cuota, sin coste. El LLM host hace todo el trabajo.
+
+---
+
+## 🤝 Contribuir
+
+PRs bienvenidos en:
+- **Prompts de agentes** — mejorar el comportamiento de un especialista
+- **UX de descubrimiento** — mejorar `maifady_list_agents` o las descripciones de herramientas
+- **Nuevos clientes** — añadir un ejemplo de config para un cliente no cubierto
+
+Ver [github.com/MaFady/maifady-plugin/blob/main/CONTRIBUTING.es.md](https://github.com/MaFady/maifady-plugin/blob/main/CONTRIBUTING.es.md).
+
+---
+
+## 📜 Licencia
+
+[MIT](LICENSE) — usa, fork, modifica, redistribuye libremente.
+
+---
+
+## 🌐 Ecosistema Maifady
+
+- 🤖 [**maifady-plugin**](https://github.com/MaFady/maifady-plugin) — Plugin Claude Code nativo (CLI + Desktop)
+- 🎨 [**maifady-cursor**](https://github.com/MaFady/maifady-cursor) — Reglas `.mdc` Cursor
+- 🔌 [**maifady-mcp**](https://github.com/MaFady/maifady-mcp) — Servidor MCP universal (este repo)
+- 🌍 [**maifady.com**](https://mafady.fr) — Documentación, catálogo, ejemplos
+
+<div align="center">
+
+**Hecho con ❤️ para desarrolladores de todo el mundo.**
+
+[⬆ Volver arriba](#-servidor-mcp-maifady)
+
+</div>

package/README.fr.md

@@ -0,0 +1,244 @@
+<div align="center">
+
+# 🔌 Serveur MCP Maifady
+
+**30 agents IA d'ingénierie spécialisés — pour tout client compatible MCP**
+
+> 🌍 [English](README.md) · **[Français](README.fr.md)** · [Español](README.es.md) · [中文](README.zh-CN.md) · [日本語](README.ja.md)
+
+[![Licence : MIT](https://img.shields.io/badge/Licence-MIT-yellow.svg)](LICENSE)
+[![MCP](https://img.shields.io/badge/MCP-compatible-blueviolet)](https://modelcontextprotocol.io)
+[![npm](https://img.shields.io/badge/npm-maifady--mcp-red)](https://www.npmjs.com/package/maifady-mcp)
+[![Agents](https://img.shields.io/badge/agents-30-blue)](agents/)
+[![100% gratuit](https://img.shields.io/badge/100%25-gratuit-success)](#)
+
+[**Installation**](#-installation) · [**Clients**](#-clients-supportés) · [**Agents**](#-les-30-agents) · [**Fonctionnement**](#-comment-ça-marche)
+
+</div>
+
+---
+
+## ⚡ C'est quoi ?
+
+**Le serveur MCP Maifady** expose 30 agents d'ingénierie spécialisés via le [Model Context Protocol](https://modelcontextprotocol.io) — la norme ouverte pour connecter les assistants IA à des outils. Installe-le une fois, utilise les mêmes 30 spécialistes dans :
+
+- 🎨 **Cursor**
+- 🖥️ **Claude Desktop**
+- 💻 **Cline** (extension VS Code)
+- ⚡ **Zed**
+- 🔧 **N'importe quel autre client MCP**
+
+Un seul code. Tous les clients. Pas de réinstallation par IDE.
+
+- ✅ **100% gratuit** — licence MIT, pas d'inscription, pas de télémétrie, aucune clé API
+- ✅ **100% local** — tourne sur ta machine via `npx` ou install local
+- ✅ **30 spécialistes** — revue de code, optimisation SQL, audit sécurité, refactoring, Docker, K8s, Terraform, etc.
+- ✅ **Natif MCP** — transport `stdio` standard, compatible [@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/typescript-sdk)
+
+---
+
+## 🚀 Installation
+
+### Prérequis
+
+- **Node.js ≥ 18** (nécessaire pour `npx maifady-mcp`)
+
+### Voie la plus rapide : `npx` (pas d'install)
+
+Les exemples de config ci-dessous utilisent tous `npx -y maifady-mcp`, qui télécharge et lance la dernière version à chaque invocation. **Pas d'install globale nécessaire.**
+
+### Ou installation globale
+
+```bash
+npm install -g maifady-mcp
+```
+
+Puis réfère-le comme `maifady-mcp` dans ta config (au lieu de `npx -y maifady-mcp`).
+
+---
+
+## 🛠 Clients supportés
+
+### Cursor
+
+Enregistre dans `.cursor/mcp.json` (par projet) ou `~/.cursor/mcp.json` (global) :
+
+```json
+{
+  "mcpServers": {
+    "maifady": {
+      "command": "npx",
+      "args": ["-y", "maifady-mcp"]
+    }
+  }
+}
+```
+
+Ouvre Cursor → les 30 agents apparaissent comme outils dans le chat. Invoque-les naturellement :
+
+```
+Review cette requête pour les bottlenecks : SELECT * FROM orders WHERE ...
+```
+
+Cursor choisira `maifady_sql_optimizer` automatiquement — ou appellera `maifady_list_agents` d'abord pour voir ce qui est dispo.
+
+### Claude Desktop
+
+Enregistre dans `claude_desktop_config.json` :
+- **macOS** : `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows** : `%APPDATA%\Claude\claude_desktop_config.json`
+- **Linux** : `~/.config/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "maifady": {
+      "command": "npx",
+      "args": ["-y", "maifady-mcp"]
+    }
+  }
+}
+```
+
+Redémarre Claude Desktop. Les 30 agents sont maintenant dispo — cherche l'icône 🔌 dans l'entrée du chat.
+
+### Cline (extension VS Code)
+
+Ouvre le panneau Cline → Settings → MCP Servers, ou édite `cline_mcp_settings.json` :
+
+```json
+{
+  "mcpServers": {
+    "maifady": {
+      "command": "npx",
+      "args": ["-y", "maifady-mcp"],
+      "disabled": false,
+      "autoApprove": []
+    }
+  }
+}
+```
+
+### Zed
+
+Édite `~/.config/zed/settings.json` (Linux/macOS) ou `%APPDATA%\Zed\settings.json` (Windows) :
+
+```json
+{
+  "context_servers": {
+    "maifady": {
+      "command": {
+        "path": "npx",
+        "args": ["-y", "maifady-mcp"]
+      }
+    }
+  }
+}
+```
+
+### Tout autre client MCP
+
+Le serveur parle MCP standard via `stdio`. Tout client supportant le protocole peut l'utiliser — voir [modelcontextprotocol.io/clients](https://modelcontextprotocol.io/clients).
+
+---
+
+## 🎯 Utilisation
+
+Une fois connecté, ton client voit **31 outils** :
+
+| Outil | Rôle |
+|---|---|
+| `maifady_list_agents` | Découverte — liste les 30 agents avec descriptions. Appelle-le d'abord si ton client a besoin d'aide pour router. |
+| `maifady_sql_optimizer` | Optimiser une requête lente |
+| `maifady_code_reviewer_pro` | Review PR niveau principal engineer |
+| `maifady_security_auditor` | Audit sécurité OWASP/ASVS |
+| `maifady_dockerfile_optimizer` | Réduire + durcir un Dockerfile |
+| `maifady_terraform_writer` | Terraform production-grade |
+| `maifady_react_modernizer` | Migrer React legacy vers hooks |
+| `maifady_accessibility_auditor` | Audit WCAG 2.2 AA |
+| `maifady_e2e_test_writer` | E2E fiables Playwright/Cypress |
+| `maifady_regex_explainer` | Décoder + durcir une regex |
+| ... | ... 22 spécialistes en plus ... |
+
+Chaque outil prend un seul paramètre `task` (string). Le serveur retourne le system prompt complet de l'agent autour de ta tâche — le LLM hôte adopte ce rôle et produit la réponse.
+
+### Exemples
+
+```
+Utilise maifady_sql_optimizer pour fixer cette requête : SELECT * FROM orders WHERE YEAR(created_at)=2024
+```
+
+```
+Lance maifady_security_auditor sur le flow d'auth dans src/middleware/
+```
+
+Ou décris simplement la tâche — la plupart des clients picotent le bon outil tout seuls :
+
+```
+Ce Dockerfile fait 1.2 GB. Réduis-le.
+```
+
+---
+
+## 🤖 Les 30 agents
+
+| Catégorie | Agents |
+|---|---|
+| **Qualité du code** | `code-reviewer-lite`, `code-reviewer-pro`, `security-auditor`, `refactor-assistant`, `dead-code-finder`, `complexity-analyzer` |
+| **DB & Perf** | `sql-optimizer`, `schema-designer`, `migration-writer`, `perf-profiler` |
+| **Tests** | `test-generator`, `e2e-test-writer`, `coverage-improver` |
+| **Git & Docs** | `commit-message-writer`, `readme-generator`, `gitignore-generator`, `tech-writer`, `api-doc-generator` |
+| **Frontend** | `react-modernizer`, `accessibility-auditor`, `bundle-analyzer` |
+| **Backend & API** | `api-designer`, `openapi-generator`, `microservices-architect` |
+| **DevOps & Cloud** | `dockerfile-optimizer`, `kubernetes-yaml-writer`, `terraform-writer` |
+| **IA/ML & Utils** | `prompt-engineer`, `ml-pipeline-architect`, `regex-explainer` |
+
+Le system prompt complet de chaque agent est dans `agents/<slug>.md`. Lis-les — chaque prompt est écrit pour être honnête sur le scope, pousser en arrière sur le prématuré, et produire des résultats concrets.
+
+---
+
+## 🛠 Comment ça marche
+
+1. **Démarrage** : le serveur lit chaque `agents/*.md` et parse frontmatter + body.
+2. **Enregistrement** : chaque agent devient un outil MCP `maifady_<slug>` avec sa description.
+3. **Invocation** : quand un client appelle un outil avec `{ task: "..." }`, le serveur retourne un payload texte contenant :
+   - Le system prompt de l'agent
+   - La tâche de l'utilisateur
+   - Un rappel de rester dans le scope
+4. **LLM hôte** : le LLM appelant (Claude, GPT-4, etc.) lit ce payload et produit la réponse **en tant que ce spécialiste**.
+
+Cette approche — « prompt injection via résultat d'outil » — fait que le serveur lui-même n'appelle jamais d'API IA. Pas de clé API, pas de quota, pas de coût. C'est le LLM hôte qui fait le boulot.
+
+---
+
+## 🤝 Contribuer
+
+PRs bienvenues sur :
+- **Prompts d'agents** — améliorer le comportement d'un spécialiste
+- **UX de découverte** — améliorer `maifady_list_agents` ou les descriptions des outils
+- **Nouveaux clients** — ajouter un exemple de config pour un client non couvert
+
+Voir [github.com/MaFady/maifady-plugin/blob/main/CONTRIBUTING.fr.md](https://github.com/MaFady/maifady-plugin/blob/main/CONTRIBUTING.fr.md).
+
+---
+
+## 📜 Licence
+
+[MIT](LICENSE) — utilise, fork, modifie, redistribue librement.
+
+---
+
+## 🌐 Écosystème Maifady
+
+- 🤖 [**maifady-plugin**](https://github.com/MaFady/maifady-plugin) — Plugin Claude Code natif (CLI + Desktop)
+- 🎨 [**maifady-cursor**](https://github.com/MaFady/maifady-cursor) — Règles `.mdc` Cursor
+- 🔌 [**maifady-mcp**](https://github.com/MaFady/maifady-mcp) — Serveur MCP universel (ce repo)
+- 🌍 [**maifady.com**](https://mafady.fr) — Documentation, catalogue, exemples
+
+<div align="center">
+
+**Fait avec ❤️ pour les développeurs du monde entier.**
+
+[⬆ Retour en haut](#-serveur-mcp-maifady)
+
+</div>