maifady-mcp 1.0.0

package/README.ja.md

@@ -0,0 +1,244 @@
+<div align="center">
+
+# 🔌 Maifady MCP サーバー
+
+**30 の専門 AI エンジニアリングエージェント — 任意の MCP 互換クライアント向け**
+
+> 🌍 [English](README.md) · [Français](README.fr.md) · [Español](README.es.md) · [中文](README.zh-CN.md) · **[日本語](README.ja.md)**
+
+[![ライセンス: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![MCP](https://img.shields.io/badge/MCP-互換-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% 無料](https://img.shields.io/badge/100%25-無料-success)](#)
+
+[**インストール**](#-インストール) · [**クライアント**](#-対応クライアント) · [**エージェント**](#-30-のエージェント) · [**仕組み**](#-仕組み)
+
+</div>
+
+---
+
+## ⚡ これは何?
+
+**Maifady MCP サーバー**は、[Model Context Protocol](https://modelcontextprotocol.io)(AI アシスタントとツールを接続するためのオープンスタンダード)を通じて、30 の専門エンジニアリングエージェントを公開します。一度インストールすれば、同じ 30 の専門家を以下で使用できます:
+
+- 🎨 **Cursor**
+- 🖥️ **Claude Desktop**
+- 💻 **Cline**(VS Code 拡張)
+- ⚡ **Zed**
+- 🔧 **任意の他の MCP 互換クライアント**
+
+1 つのコードベース。すべてのクライアント。IDE ごとの再インストール不要。
+
+- ✅ **100% 無料** — MIT ライセンス、登録不要、テレメトリーなし、API キー管理不要
+- ✅ **100% ローカル** — `npx` またはローカルインストールでマシン上で実行
+- ✅ **30 のスペシャリスト** — コードレビュー、SQL 最適化、セキュリティ監査、リファクタリング、Docker、K8s、Terraform など
+- ✅ **MCP ネイティブ** — 標準の `stdio` トランスポート、[@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/typescript-sdk) と互換
+
+---
+
+## 🚀 インストール
+
+### 前提条件
+
+- **Node.js ≥ 18**(`npx maifady-mcp` 実行に必要)
+
+### 最速の方法: `npx`(インストール不要)
+
+以下のすべての設定例は `npx -y maifady-mcp` を使用しており、呼び出しごとに最新版をダウンロードして実行します。**グローバルインストール不要。**
+
+### またはグローバルインストール
+
+```bash
+npm install -g maifady-mcp
+```
+
+その後、クライアント設定で `maifady-mcp` として参照します(`npx -y maifady-mcp` の代わりに)。
+
+---
+
+## 🛠 対応クライアント
+
+### Cursor
+
+`.cursor/mcp.json`(プロジェクトごと)または `~/.cursor/mcp.json`(グローバル)に保存:
+
+```json
+{
+  "mcpServers": {
+    "maifady": {
+      "command": "npx",
+      "args": ["-y", "maifady-mcp"]
+    }
+  }
+}
+```
+
+Cursor を開く → 30 のエージェントがチャットでツールとして表示されます。自然に呼び出せます:
+
+```
+このクエリのボトルネックをレビュー: SELECT * FROM orders WHERE ...
+```
+
+Cursor は `maifady_sql_optimizer` を自動的に選択 — または、利用可能なツールを確認するために最初に `maifady_list_agents` を呼び出します。
+
+### Claude Desktop
+
+`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"]
+    }
+  }
+}
+```
+
+Claude Desktop を再起動。30 のエージェントが利用可能に — チャット入力の 🔌 アイコンを探してください。
+
+### Cline(VS Code 拡張)
+
+Cline パネル → Settings → MCP Servers を開く、または `cline_mcp_settings.json` を編集:
+
+```json
+{
+  "mcpServers": {
+    "maifady": {
+      "command": "npx",
+      "args": ["-y", "maifady-mcp"],
+      "disabled": false,
+      "autoApprove": []
+    }
+  }
+}
+```
+
+### Zed
+
+`~/.config/zed/settings.json`(Linux/macOS)または `%APPDATA%\Zed\settings.json`(Windows)を編集:
+
+```json
+{
+  "context_servers": {
+    "maifady": {
+      "command": {
+        "path": "npx",
+        "args": ["-y", "maifady-mcp"]
+      }
+    }
+  }
+}
+```
+
+### 他の任意の MCP クライアント
+
+サーバーは `stdio` 上で標準 MCP を話します。プロトコルをサポートする任意のクライアントが使用可能 — [modelcontextprotocol.io/clients](https://modelcontextprotocol.io/clients) を参照。
+
+---
+
+## 🎯 使い方
+
+接続すると、クライアントは **31 のツール**を見ます:
+
+| ツール | 目的 |
+|---|---|
+| `maifady_list_agents` | 発見 — 30 のエージェントと説明を一覧表示。クライアントがルーティングのヘルプを必要とする場合、最初に呼び出します。 |
+| `maifady_sql_optimizer` | 遅いクエリを最適化 |
+| `maifady_code_reviewer_pro` | プリンシパルエンジニア級 PR レビュー |
+| `maifady_security_auditor` | OWASP/ASVS セキュリティ監査 |
+| `maifady_dockerfile_optimizer` | Dockerfile を縮小 + 強化 |
+| `maifady_terraform_writer` | プロダクショングレード Terraform |
+| `maifady_react_modernizer` | レガシー React を hooks に移行 |
+| `maifady_accessibility_auditor` | WCAG 2.2 AA 監査 |
+| `maifady_e2e_test_writer` | 信頼できる Playwright/Cypress E2E |
+| `maifady_regex_explainer` | 正規表現のデコード + 強化 |
+| ... | ... 他 22 のスペシャリスト ... |
+
+各ツールは 1 つの `task` パラメータ(文字列)を取ります。サーバーはタスクをラップしたエージェントの完全な system prompt を返します — ホスト LLM はその役割を採用して答えを生成します。
+
+### 例
+
+```
+maifady_sql_optimizer を使ってこのクエリを修正: SELECT * FROM orders WHERE YEAR(created_at)=2024
+```
+
+```
+src/middleware/ の認証フローで maifady_security_auditor を実行
+```
+
+または、タスクを記述するだけで — ほとんどのクライアントが正しいツールを自動的に選択:
+
+```
+この Dockerfile は 1.2 GB をビルドします。小さくしてください。
+```
+
+---
+
+## 🤖 30 のエージェント
+
+| カテゴリ | エージェント |
+|---|---|
+| **コード品質** | `code-reviewer-lite`, `code-reviewer-pro`, `security-auditor`, `refactor-assistant`, `dead-code-finder`, `complexity-analyzer` |
+| **DB & パフォーマンス** | `sql-optimizer`, `schema-designer`, `migration-writer`, `perf-profiler` |
+| **テスト** | `test-generator`, `e2e-test-writer`, `coverage-improver` |
+| **Git & ドキュメント** | `commit-message-writer`, `readme-generator`, `gitignore-generator`, `tech-writer`, `api-doc-generator` |
+| **フロントエンド** | `react-modernizer`, `accessibility-auditor`, `bundle-analyzer` |
+| **バックエンド & API** | `api-designer`, `openapi-generator`, `microservices-architect` |
+| **DevOps & クラウド** | `dockerfile-optimizer`, `kubernetes-yaml-writer`, `terraform-writer` |
+| **AI/ML & ユーティリティ** | `prompt-engineer`, `ml-pipeline-architect`, `regex-explainer` |
+
+各エージェントの完全な system prompt は `agents/<slug>.md` にあります。読んでください — 各プロンプトはスコープについて正直で、時期尚早の場合は押し戻し、具体的なアクション可能な出力を生成するように意図的に書かれています。
+
+---
+
+## 🛠 仕組み
+
+1. **起動**: サーバーは各 `agents/*.md` ファイルを読み、frontmatter + body をパース。
+2. **登録**: 各エージェントは frontmatter の説明とともに `maifady_<slug>` という MCP ツールになります。
+3. **呼び出し**: クライアントが `{ task: "..." }` でツールを呼ぶと、サーバーは以下を含むテキストペイロードを返します:
+   - エージェントの system prompt
+   - ユーザーのタスク
+   - エージェントのスコープ内にとどまるリマインダー
+4. **ホスト LLM**: 呼び出し元の LLM(Claude、GPT-4 など)はこのペイロードを読み、**そのスペシャリストとして**答えを生成します。
+
+このパターン — 「ツール結果による prompt インジェクション」 — は、サーバー自体が AI API を一切呼び出さないことを意味します。API キーなし、クォータなし、コストなし。ホスト LLM がすべての作業を行います。
+
+---
+
+## 🤝 貢献
+
+PR を歓迎:
+- **エージェントプロンプト** — スペシャリストの振る舞いを改善
+- **発見 UX** — `maifady_list_agents` またはツール説明を改善
+- **新しいクライアント** — カバーされていないクライアントの設定例を追加
+
+詳細ガイドは [github.com/MaFady/maifady-plugin/blob/main/CONTRIBUTING.ja.md](https://github.com/MaFady/maifady-plugin/blob/main/CONTRIBUTING.ja.md) を参照。
+
+---
+
+## 📜 ライセンス
+
+[MIT](LICENSE) — 自由に使用、フォーク、変更、再配布できます。
+
+---
+
+## 🌐 Maifady エコシステム
+
+- 🤖 [**maifady-plugin**](https://github.com/MaFady/maifady-plugin) — ネイティブ Claude Code プラグイン(CLI + Desktop)
+- 🎨 [**maifady-cursor**](https://github.com/MaFady/maifady-cursor) — Cursor `.mdc` ルール
+- 🔌 [**maifady-mcp**](https://github.com/MaFady/maifady-mcp) — ユニバーサル MCP サーバー(このリポジトリ)
+- 🌍 [**maifady.com**](https://mafady.fr) — ドキュメント、カタログ、サンプル
+
+<div align="center">
+
+**世界中の開発者のために ❤️ を込めて。**
+
+[⬆ トップへ戻る](#-maifady-mcp-サーバー)
+
+</div>

package/README.md

@@ -0,0 +1,298 @@
+<div align="center">
+
+# 🔌 Maifady MCP Server
+
+**30 specialist AI engineering agents — for any MCP-compatible client**
+
+> 🌍 **[English](README.md)** · [Français](README.fr.md) · [Español](README.es.md) · [中文](README.zh-CN.md) · [日本語](README.ja.md)
+
+[![License: MIT](https://img.shields.io/badge/License-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% Free](https://img.shields.io/badge/100%25-free-success)](#)
+
+[**Install**](#-installation) · [**Clients**](#-supported-clients) · [**Agents**](#-the-30-agents) · [**How it works**](#-how-it-works)
+
+</div>
+
+---
+
+## ⚡ What is this?
+
+**Maifady MCP Server** exposes 30 specialist engineering agents through the [Model Context Protocol](https://modelcontextprotocol.io) — the open standard for connecting AI assistants to tools. Install it once, use the same 30 specialists in:
+
+- 🎨 **Cursor**
+- 🖥️ **Claude Desktop**
+- 💻 **Cline** (VS Code extension)
+- ⚡ **Zed**
+- 🔧 **Any other MCP-compatible client**
+
+One codebase. Every client. No re-installation per IDE.
+
+- ✅ **100% free** — MIT license, no signup, no telemetry, no API keys to manage
+- ✅ **100% local** — runs on your machine via `npx` or local install
+- ✅ **30 specialists** — code review, SQL optimization, security audit, refactoring, Docker, K8s, Terraform, and more
+- ✅ **MCP-native** — standard `stdio` transport, works with the [@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/typescript-sdk)
+
+---
+
+## 🚀 Installation
+
+### Prerequisites
+
+- **Node.js ≥ 18** (required to run `npx maifady-mcp`)
+
+### Quickest path: `npx` (no install needed)
+
+The configuration examples below all use `npx -y maifady-mcp`, which downloads and runs the latest version on each invocation. **No global install required.**
+
+### Or install globally
+
+```bash
+npm install -g maifady-mcp
+```
+
+Then reference it as `maifady-mcp` in your client config (instead of `npx -y maifady-mcp`).
+
+---
+
+## 🛠 Supported clients
+
+### Cursor
+
+Save into `.cursor/mcp.json` (per project) or `~/.cursor/mcp.json` (global):
+
+```json
+{
+  "mcpServers": {
+    "maifady": {
+      "command": "npx",
+      "args": ["-y", "maifady-mcp"]
+    }
+  }
+}
+```
+
+Open Cursor → the 30 agents appear as tools in the chat. Invoke them naturally:
+
+```
+Review this query for bottlenecks: SELECT * FROM orders WHERE ...
+```
+
+Cursor will pick `maifady_sql_optimizer` automatically — or call `maifady_list_agents` first to see what's available.
+
+### Claude Desktop
+
+Save into `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"]
+    }
+  }
+}
+```
+
+Restart Claude Desktop. The 30 agents are now available — look for the 🔌 plug icon in the chat input.
+
+### Cline (VS Code extension)
+
+Open Cline panel → Settings → MCP Servers, or edit `cline_mcp_settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "maifady": {
+      "command": "npx",
+      "args": ["-y", "maifady-mcp"],
+      "disabled": false,
+      "autoApprove": []
+    }
+  }
+}
+```
+
+### Zed
+
+Edit `~/.config/zed/settings.json` (Linux/macOS) or `%APPDATA%\Zed\settings.json` (Windows):
+
+```json
+{
+  "context_servers": {
+    "maifady": {
+      "command": {
+        "path": "npx",
+        "args": ["-y", "maifady-mcp"]
+      }
+    }
+  }
+}
+```
+
+### Any other MCP client
+
+The server speaks standard MCP over `stdio`. Any client that supports the protocol can use it — see [modelcontextprotocol.io/clients](https://modelcontextprotocol.io/clients) for the up-to-date list.
+
+---
+
+## 🎯 Usage
+
+Once connected, your client sees **31 tools**:
+
+| Tool | Purpose |
+|---|---|
+| `maifady_list_agents` | Discovery — lists all 30 agents with descriptions. Call this first if your client needs help routing. |
+| `maifady_sql_optimizer` | Optimize a slow query |
+| `maifady_code_reviewer_pro` | Principal-engineer PR review |
+| `maifady_security_auditor` | OWASP/ASVS security audit |
+| `maifady_dockerfile_optimizer` | Shrink + harden a Dockerfile |
+| `maifady_terraform_writer` | Production-grade Terraform |
+| `maifady_react_modernizer` | Migrate legacy React to hooks |
+| `maifady_accessibility_auditor` | WCAG 2.2 AA audit |
+| `maifady_e2e_test_writer` | Reliable Playwright/Cypress E2E |
+| `maifady_regex_explainer` | Decode + harden a regex |
+| ... | ... 22 more specialists ... |
+
+Each tool takes a single `task` parameter (string). The server returns the agent's full system prompt wrapped around your task — the host LLM then adopts that role and produces the answer.
+
+### Example invocations
+
+```
+Use maifady_sql_optimizer to fix this query: SELECT * FROM orders WHERE YEAR(created_at)=2024
+```
+
+```
+Run maifady_security_auditor on the auth flow in src/middleware/
+```
+
+```
+Ask maifady_dockerfile_optimizer to review this Dockerfile and cut the image size
+```
+
+Or just describe the task — most clients will pick the right tool automatically:
+
+```
+This Dockerfile builds 1.2 GB. Make it smaller.
+```
+
+---
+
+## 🤖 The 30 agents
+
+| Category | Agents |
+|---|---|
+| **Code Quality** | `code-reviewer-lite`, `code-reviewer-pro`, `security-auditor`, `refactor-assistant`, `dead-code-finder`, `complexity-analyzer` |
+| **Database & Perf** | `sql-optimizer`, `schema-designer`, `migration-writer`, `perf-profiler` |
+| **Testing** | `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` |
+| **AI/ML & Utils** | `prompt-engineer`, `ml-pipeline-architect`, `regex-explainer` |
+
+Each agent's full system prompt is shipped in `agents/<slug>.md`. Read them — every prompt is intentionally written to be honest about scope, push back when premature, and produce concrete actionable output.
+
+---
+
+## 🛠 How it works
+
+1. **Startup**: the server reads every `agents/*.md` file and parses the frontmatter + body.
+2. **Registration**: each agent becomes one MCP tool named `maifady_<slug>` with the description from the frontmatter.
+3. **Invocation**: when a client calls a tool with `{ task: "..." }`, the server returns a text payload containing:
+   - The agent's system prompt
+   - The user's task
+   - A reminder to stay within the agent's scope
+4. **Host LLM**: the calling LLM (Claude, GPT-4, etc.) reads this payload and produces the answer **as that specialist**.
+
+This pattern — "prompt injection through tool result" — means the server itself never calls any AI API. It has no API key, no quota, no cost. The host LLM does all the work.
+
+---
+
+## 🏗 Architecture
+
+```
+maifady-mcp/
+├── package.json
+├── tsconfig.json
+├── src/
+│   ├── server.ts        ← MCP server entry point (stdio transport)
+│   └── agents.ts        ← Agent loader + response builder
+├── agents/              ← 30 source .md files
+│   ├── code-reviewer-pro.md
+│   ├── sql-optimizer.md
+│   └── ... (28 more)
+├── bin/
+│   └── maifady-mcp.js   ← npm bin launcher
+├── config-examples/
+│   ├── cursor.json
+│   ├── claude-desktop.json
+│   ├── cline.json
+│   └── zed.json
+└── dist/                ← compiled output (npm publish)
+```
+
+---
+
+## 🧪 Development
+
+```bash
+git clone https://github.com/MaFady/maifady-mcp.git
+cd maifady-mcp
+npm install
+npm run build
+node dist/server.js     # smoke-test (server speaks stdio MCP — pipe input to test)
+```
+
+To test against a real client, point its `mcp.json` at your local build:
+
+```json
+{
+  "mcpServers": {
+    "maifady-dev": {
+      "command": "node",
+      "args": ["/absolute/path/to/maifady-mcp/dist/server.js"]
+    }
+  }
+}
+```
+
+---
+
+## 🤝 Contributing
+
+PRs welcome on:
+- **Agent prompts** — improve a specialist's behavior or fix an edge case
+- **Discovery UX** — improve `maifady_list_agents` output or the per-tool descriptions
+- **New clients** — add a config example for a client we don't cover yet
+
+See [github.com/MaFady/maifady-plugin/blob/main/CONTRIBUTING.md](https://github.com/MaFady/maifady-plugin/blob/main/CONTRIBUTING.md) for the full guide.
+
+---
+
+## 📜 License
+
+[MIT](LICENSE) — use, fork, modify, redistribute freely.
+
+---
+
+## 🌐 Maifady ecosystem
+
+- 🤖 [**maifady-plugin**](https://github.com/MaFady/maifady-plugin) — Native Claude Code plugin (CLI + Desktop)
+- 🎨 [**maifady-cursor**](https://github.com/MaFady/maifady-cursor) — Cursor `.mdc` rules
+- 🔌 [**maifady-mcp**](https://github.com/MaFady/maifady-mcp) — Universal MCP server (this repo)
+- 🌍 [**maifady.com**](https://mafady.fr) — Documentation, agent catalog, examples
+
+<div align="center">
+
+**Made with ❤️ for developers worldwide.**
+
+[⬆ Back to top](#-maifady-mcp-server)
+
+</div>