{"_id":"@chenfy1993/eyoucms-mcp-server","name":"@chenfy1993/eyoucms-mcp-server","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@chenfy1993/eyoucms-mcp-server","version":"1.0.0","description":"Model Context Protocol server for EyouCMS development with specialized tools","main":"index.js","type":"module","bin":{"eyoucms-mcp":"index.js"},"keywords":["mcp","eyoucms","model-context-protocol","thinkphp","cms","plugin-development"],"author":{"name":"chenfy"},"license":"MIT","engines":{"node":">=18.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^0.5.0","axios":"^1.6.0"},"devDependencies":{"jest":"^29.7.0"},"scripts":{"start":"node index.js","test":"jest"},"repository":{"type":"git","url":"git+https://github.com/chenfy/eyoucms-mcp-server.git"},"publishConfig":{"access":"public"},"_id":"@chenfy1993/eyoucms-mcp-server@1.0.0","bugs":{"url":"https://github.com/chenfy/eyoucms-mcp-server/issues"},"homepage":"https://github.com/chenfy/eyoucms-mcp-server#readme","_nodeVersion":"20.11.0","_npmVersion":"10.2.4","dist":{"integrity":"sha512-cV32ivuO99dXP0k3hXAnG5ne3HtZLijW/mms94ZlirTPsjGSAg4fGzhezOyBgrMs1554q0IdZnp0Q+psuowvlA==","shasum":"c5aa688ff1dea0610bf7a620900100c386a6c56c","tarball":"https://registry.npmjs.org/@chenfy1993/eyoucms-mcp-server/-/eyoucms-mcp-server-1.0.0.tgz","fileCount":19,"unpackedSize":109936,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIEl4lwdarAtRIWPti0WYpmrgLBhP1FPXGYsPzJA7id25AiBT3g8xpMJ0WhMaMPufKQp3GuXz9DR/QJdpz2X/PXAbtw=="}]},"_npmUser":{"name":"chenfy1993","email":"491085389@qq.com"},"directories":{},"maintainers":[{"name":"chenfy1993","email":"491085389@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/eyoucms-mcp-server_1.0.0_1761033245164_0.4248429190828735"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-21T07:54:05.069Z","1.0.0":"2025-10-21T07:54:05.358Z","modified":"2025-10-21T07:54:05.623Z"},"maintainers":[{"name":"chenfy1993","email":"491085389@qq.com"}],"description":"Model Context Protocol server for EyouCMS development with specialized tools","homepage":"https://github.com/chenfy/eyoucms-mcp-server#readme","keywords":["mcp","eyoucms","model-context-protocol","thinkphp","cms","plugin-development"],"repository":{"type":"git","url":"git+https://github.com/chenfy/eyoucms-mcp-server.git"},"author":{"name":"chenfy"},"bugs":{"url":"https://github.com/chenfy/eyoucms-mcp-server/issues"},"license":"MIT","readme":"# EyouCMS MCP 服务器\r\n\r\n专为 EyouCMS 开发定制的 Model Context Protocol (MCP) 服务器，提供强大的开发工具集。\r\n\r\n## 🎯 功能特性\r\n\r\n### 📦 插件开发工具\r\n- ✅ **插件标识检测**：检测插件标识是否已被使用\r\n- 🔄 **自动生成标识**：智能生成唯一的插件标识\r\n- 📋 **插件列表**：查看所有已安装的插件\r\n- 🔍 **插件信息**：获取插件详细配置和结构\r\n- ✔️ **结构验证**：验证插件目录结构是否完整\r\n\r\n### 🗄️ 数据库管理工具\r\n- 📊 **表结构查询**：查看 EyouCMS 数据表结构\r\n- 🔧 **SQL生成器**：自动生成 install.sql 和 uninstall.sql\r\n- 📝 **配置分析**：分析数据库配置信息\r\n\r\n### 🎨 模板开发工具\r\n- 📖 **标签列表**：查询 EyouCMS 模板标签用法\r\n- ✅ **语法检查**：检查模板文件语法正确性\r\n- 🏗️ **模板生成**：一键生成插件后台模板\r\n- 📱 **前台模板**：创建 PC 和移动端前台模板\r\n\r\n### 📊 项目分析工具\r\n- 🔍 **结构分析**：分析项目整体结构和统计信息\r\n- 📌 **版本信息**：获取 EyouCMS 版本和配置\r\n- 🔎 **代码搜索**：在项目中搜索代码和文本\r\n- 📏 **目录大小**：计算指定目录的大小\r\n\r\n### 🔒 安全检查工具\r\n- 🛡️ **安全扫描**：检测插件代码的安全问题\r\n- 📏 **规范检查**：验证代码是否符合开发规范\r\n- 🔐 **权限验证**：确保插件只在允许的目录中操作\r\n\r\n## 📦 安装\r\n\r\n### 前置要求\r\n- Node.js >= 18.0.0\r\n- EyouCMS 项目\r\n\r\n### 安装步骤\r\n\r\n#### 方法一：全局安装（推荐）\r\n```bash\r\nnpm install -g @chenfy/eyoucms-mcp-server\r\n```\r\n\r\n#### 方法二：本地开发\r\n```bash\r\ncd eyoucms-mcp-server\r\nnpm install\r\n```\r\n\r\n## ⚙️ 配置\r\n\r\n### 在 Cursor 中配置\r\n\r\n编辑 Cursor 的 MCP 配置文件：\r\n\r\n**Windows**: `C:\\Users\\<用户名>\\AppData\\Roaming\\Cursor\\User\\globalStorage\\mcp.json`\r\n\r\n**Mac**: `~/Library/Application Support/Cursor/User/globalStorage/mcp.json`\r\n\r\n添加以下配置：\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"eyoucms\": {\r\n      \"command\": \"node\",\r\n      \"args\": [\r\n        \"E:\\\\chenfy_eyou\\\\test_173\\\\eyoucms-mcp-server\\\\index.js\",\r\n        \"E:\\\\chenfy_eyou\\\\test_173\"\r\n      ],\r\n      \"description\": \"EyouCMS 开发工具集\"\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n或者使用 npx（如果已全局安装）：\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"eyoucms\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\r\n        \"-y\",\r\n        \"@chenfy/eyoucms-mcp-server\",\r\n        \"E:\\\\chenfy_eyou\\\\test_173\"\r\n      ],\r\n      \"description\": \"EyouCMS 开发工具集\"\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n重启 Cursor 后，MCP 服务器将自动启动。\r\n\r\n## 🚀 使用示例\r\n\r\n### 1. 检测插件标识唯一性\r\n\r\n```javascript\r\n// 在 Cursor 中询问 AI：\r\n\"检测插件标识 MyShop 是否可用\"\r\n\r\n// AI 将调用：\r\n{\r\n  \"tool\": \"check_plugin_code_unique\",\r\n  \"arguments\": {\r\n    \"code\": \"MyShop\"\r\n  }\r\n}\r\n```\r\n\r\n### 2. 生成唯一插件标识\r\n\r\n```javascript\r\n// 在 Cursor 中询问 AI：\r\n\"帮我生成一个以 Shop 为基础的唯一插件标识\"\r\n\r\n// AI 将调用：\r\n{\r\n  \"tool\": \"generate_unique_plugin_code\",\r\n  \"arguments\": {\r\n    \"baseName\": \"Shop\"\r\n  }\r\n}\r\n```\r\n\r\n### 3. 查看已安装插件\r\n\r\n```javascript\r\n// 在 Cursor 中询问 AI：\r\n\"列出所有已安装的插件\"\r\n\r\n// AI 将调用：\r\n{\r\n  \"tool\": \"list_installed_plugins\",\r\n  \"arguments\": {\r\n    \"includeDetails\": true\r\n  }\r\n}\r\n```\r\n\r\n### 4. 生成插件模板\r\n\r\n```javascript\r\n// 在 Cursor 中询问 AI：\r\n\"为插件 MyShop 生成后台首页模板\"\r\n\r\n// AI 将调用：\r\n{\r\n  \"tool\": \"generate_plugin_template\",\r\n  \"arguments\": {\r\n    \"pluginCode\": \"MyShop\",\r\n    \"templateType\": \"index\"\r\n  }\r\n}\r\n```\r\n\r\n### 5. 安全检查\r\n\r\n```javascript\r\n// 在 Cursor 中询问 AI：\r\n\"检查插件 MyShop 的安全性\"\r\n\r\n// AI 将调用：\r\n{\r\n  \"tool\": \"check_plugin_security\",\r\n  \"arguments\": {\r\n    \"pluginCode\": \"MyShop\"\r\n  }\r\n}\r\n```\r\n\r\n## 🛠️ 可用工具列表\r\n\r\n### 插件工具 (6个)\r\n- `check_plugin_code_unique` - 检测插件标识唯一性\r\n- `generate_unique_plugin_code` - 自动生成唯一标识\r\n- `list_installed_plugins` - 列出已安装插件\r\n- `get_plugin_info` - 获取插件详细信息\r\n- `get_plugin_structure` - 获取插件目录结构\r\n- `validate_plugin_structure` - 验证插件结构完整性\r\n\r\n### 数据库工具 (5个)\r\n- `list_database_tables` - 列出所有数据表\r\n- `get_table_structure` - 获取表结构定义\r\n- `generate_install_sql` - 生成安装SQL文件\r\n- `generate_uninstall_sql` - 生成卸载SQL文件\r\n- `analyze_database_config` - 分析数据库配置\r\n\r\n### 模板工具 (4个)\r\n- `list_template_tags` - 列出常用模板标签\r\n- `check_template_syntax` - 检查模板语法\r\n- `generate_plugin_template` - 生成后台模板\r\n- `create_plugin_frontend_template` - 创建前台模板\r\n\r\n### 项目工具 (4个)\r\n- `analyze_project_structure` - 分析项目结构\r\n- `get_project_info` - 获取项目信息\r\n- `search_in_project` - 项目代码搜索\r\n- `get_directory_size` - 计算目录大小\r\n\r\n### 安全工具 (3个)\r\n- `check_plugin_security` - 安全扫描\r\n- `check_code_standards` - 代码规范检查\r\n- `validate_plugin_permissions` - 权限验证\r\n\r\n## 📖 开发指南\r\n\r\n### 项目结构\r\n\r\n```\r\neyoucms-mcp-server/\r\n├── package.json              # npm 配置\r\n├── index.js                  # 入口文件\r\n├── src/\r\n│   ├── tools/               # 工具集\r\n│   │   ├── plugin.js        # 插件工具\r\n│   │   ├── database.js      # 数据库工具\r\n│   │   ├── template.js      # 模板工具\r\n│   │   ├── project.js       # 项目工具\r\n│   │   ├── security.js      # 安全工具\r\n│   │   └── index.js         # 工具注册\r\n│   └── utils/               # 工具函数\r\n│       ├── fileUtils.js     # 文件操作\r\n│       ├── validator.js     # 数据验证\r\n│       └── apiClient.js     # API 调用\r\n└── README.md                # 文档\r\n```\r\n\r\n### 添加新工具\r\n\r\n1. 在 `src/tools/` 目录下创建新的工具文件\r\n2. 实现工具函数，返回工具数组\r\n3. 在 `src/tools/index.js` 中注册新工具\r\n\r\n示例：\r\n\r\n```javascript\r\n// src/tools/mytools.js\r\nexport function createMyTools(projectPath) {\r\n  return [\r\n    {\r\n      name: \"my_tool\",\r\n      description: \"我的工具描述\",\r\n      inputSchema: {\r\n        type: \"object\",\r\n        properties: {\r\n          param: {\r\n            type: \"string\",\r\n            description: \"参数说明\"\r\n          }\r\n        },\r\n        required: [\"param\"]\r\n      },\r\n      handler: async (args) => {\r\n        const { param } = args;\r\n        \r\n        // 工具逻辑\r\n        \r\n        return {\r\n          success: true,\r\n          result: \"结果\"\r\n        };\r\n      }\r\n    }\r\n  ];\r\n}\r\n```\r\n\r\n## 🐛 故障排除\r\n\r\n### MCP 服务器未启动\r\n\r\n1. 检查 Node.js 版本是否 >= 18.0.0\r\n2. 确认 `mcp.json` 配置文件路径正确\r\n3. 检查项目路径是否存在\r\n4. 重启 Cursor\r\n\r\n### 工具调用失败\r\n\r\n1. 查看 Cursor 的开发者工具（F12）中的错误信息\r\n2. 确认项目路径配置正确\r\n3. 检查插件目录是否存在\r\n\r\n### 依赖安装问题\r\n\r\n```bash\r\n# 清除缓存\r\nnpm cache clean --force\r\n\r\n# 重新安装\r\nrm -rf node_modules package-lock.json\r\nnpm install\r\n```\r\n\r\n## 📝 更新日志\r\n\r\n### v1.0.0 (2025-10-21)\r\n- ✨ 首次发布\r\n- 📦 实现 22 个开发工具\r\n- 🔧 支持插件开发全流程\r\n- 🛡️ 集成安全检查功能\r\n- 📖 完整的文档和示例\r\n\r\n## 📄 许可证\r\n\r\nMIT License\r\n\r\n## 👥 贡献\r\n\r\n欢迎提交 Issue 和 Pull Request！\r\n\r\n## 📮 联系方式\r\n\r\n- GitHub: https://github.com/chenfy/eyoucms-mcp-server\r\n- Email: your-email@example.com\r\n\r\n## 🙏 致谢\r\n\r\n感谢 EyouCMS 团队提供优秀的 CMS 系统。\r\n\r\n---\r\n\r\n**享受开发！** 🚀\r\n\r\n","readmeFilename":"README.md","_rev":"1-adff3256b3433af1912a858c90e47486"}