🔌 Maifady MCP 服务器

30 个专精 AI 工程师 Agent — 适用于任何兼容 MCP 的客户端

🌍 English · Français · Español · 中文 · 日本語

安装 · 客户端 · Agents · 工作原理

⚡ 这是什么?

Maifady MCP 服务器通过 Model Context Protocol 暴露 30 个工程师专家 agent —— 这是连接 AI 助手与工具的开放标准。一次安装,在以下环境中使用同样的 30 个专家:

• 🎨 Cursor
• 🖥️ Claude Desktop
• 💻 Cline(VS Code 扩展)
• ⚡ Zed
• 🔧 任何其他 MCP 兼容客户端

一个代码库。所有客户端。无需为每个 IDE 重新安装。

• ✅ 100% 免费 — MIT 许可证,无需注册,无遥测,无需 API key
• ✅ 100% 本地 — 通过 npx 或本地安装在你的机器上运行
• ✅ 30 个专家 — 代码审查、SQL 优化、安全审计、重构、Docker、K8s、Terraform 等
• ✅ MCP 原生 — 标准 stdio 传输,兼容 @modelcontextprotocol/sdk

🚀 安装

前置要求

• Node.js ≥ 18(运行 npx maifady-mcp 所需)

最快路径:npx(无需安装)

下面所有配置示例都使用 npx -y maifady-mcp,它会在每次调用时下载并运行最新版本。无需全局安装。

或全局安装

npm install -g maifady-mcp

然后在你的客户端配置中使用 maifady-mcp(替换 npx -y maifady-mcp)。

🛠 支持的客户端

Cursor

保存到 .cursor/mcp.json(项目级)或 ~/.cursor/mcp.json(全局):

{
  "mcpServers": {
    "maifady": {
      "command": "npx",
      "args": ["-y", "maifady-mcp"]
    }
  }
}

打开 Cursor → 30 个 agent 作为工具出现在聊天中。自然地调用它们:

审查这个查询的瓶颈: 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

{
  "mcpServers": {
    "maifady": {
      "command": "npx",
      "args": ["-y", "maifady-mcp"]
    }
  }
}

重启 Claude Desktop。30 个 agent 现在可用 —— 在聊天输入框找 🔌 图标。

Cline(VS Code 扩展)

打开 Cline 面板 → Settings → MCP Servers,或编辑 cline_mcp_settings.json:

{
  "mcpServers": {
    "maifady": {
      "command": "npx",
      "args": ["-y", "maifady-mcp"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Zed

编辑 ~/.config/zed/settings.json(Linux/macOS)或 %APPDATA%\Zed\settings.json(Windows):

{
  "context_servers": {
    "maifady": {
      "command": {
        "path": "npx",
        "args": ["-y", "maifady-mcp"]
      }
    }
  }
}

任何其他 MCP 客户端

服务器通过 stdio 说标准 MCP。任何支持该协议的客户端都可以使用 —— 参见 modelcontextprotocol.io/clients。

🎯 使用

连接后,你的客户端会看到 31 个工具:

| 工具 | 用途 | |---|---| | maifady_list_agents | 发现 —— 列出所有 30 个 agent 及描述。如果你的客户端需要路由帮助,先调用它。 | | maifady_sql_optimizer | 优化慢查询 | | maifady_code_reviewer_pro | Principal-engineer 级 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 个专家 ... |

每个工具接受一个 task 参数(字符串)。服务器返回 agent 的完整 system prompt,包裹着你的任务 —— host LLM 然后采用该角色并产生答案。

示例

使用 maifady_sql_optimizer 修复这个查询: SELECT * FROM orders WHERE YEAR(created_at)=2024

对 src/middleware/ 中的认证流程运行 maifady_security_auditor

或者只描述任务 —— 大多数客户端会自动选择正确的工具:

这个 Dockerfile 构建出 1.2 GB。把它变小。

🤖 30 个 Agent

| 类别 | Agents | |---|---| | 代码质量 | code-reviewer-lite, code-reviewer-pro, security-auditor, refactor-assistant, dead-code-finder, complexity-analyzer | | 数据库与性能 | 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 |

每个 agent 的完整 system prompt 都在 agents/<slug>.md 中。读一读 —— 每个 prompt 都明确写出其范围,在过早时推回,并产生具体可操作的输出。

🛠 工作原理

1. 启动: 服务器读取每个 agents/*.md 并解析 frontmatter + body。
2. 注册: 每个 agent 成为一个 MCP 工具 maifady_<slug>,带有 frontmatter 的描述。
3. 调用: 当客户端用 { task: "..." } 调用工具时,服务器返回一个文本 payload,包含:
   • Agent 的 system prompt
   • 用户的任务
   • 保持在 agent 范围内的提醒
4. Host LLM: 调用的 LLM(Claude、GPT-4 等)读取这个 payload 并以该专家身份产生答案。

这种模式 —— "通过工具结果的 prompt 注入" —— 意味着服务器本身从不调用任何 AI API。没有 API key、没有配额、没有成本。Host LLM 做所有工作。

🤝 贡献

欢迎 PRs:

• Agent prompts —— 改进专家行为
• 发现 UX —— 改进 maifady_list_agents 或工具描述
• 新客户端 —— 为未覆盖的客户端添加配置示例

详细指南见 github.com/MaFady/maifady-plugin/blob/main/CONTRIBUTING.zh-CN.md。

📜 许可证

MIT — 自由使用、fork、修改、再发布。

🌐 Maifady 生态

• 🤖 maifady-plugin — 原生 Claude Code 插件(CLI + Desktop)
• 🎨 maifady-cursor — Cursor .mdc 规则
• 🔌 maifady-mcp — 通用 MCP 服务器(本 repo)
• 🌍 maifady.com — 文档、目录、示例

为全世界的开发者用 ❤️ 制作。

⬆ 返回顶部