vmoo-mcp-database-server 1.2.0 → 1.2.1

package/README.md

@@ -1,178 +1,214 @@
-# vmoo-mcp-database-server
-
-VMOO数据库MCP服务器 - 支持开发和生产环境的安全数据库访问
-
-[![npm version](https://badge.fury.io/js/vmoo-mcp-database-server.svg)](https://badge.fury.io/js/vmoo-mcp-database-server)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-## 🚀 快速开始
-
-### 使用npx直接运行（推荐）
-
-```bash
-# 开发环境
-npx vmoo-mcp-database-server@latest --env=dev
-
-# 生产环境
-npx vmoo-mcp-database-server@latest --env=prod
-```
-
-### 在Augment中配置
-
-```json
-{
-  "mcpServers": {
-    "vmoo-database-dev": {
-      "command": "npx",
-      "args": ["vmoo-mcp-database-server@latest", "--env=dev"]
-    },
-    "vmoo-database-prod": {
-      "command": "npx",
-      "args": ["vmoo-mcp-database-server@latest", "--env=prod"]
-    }
-  }
-}
-```
-
-### 1. 安装依赖
-
-```bash
-npm install
-```
-
-### 2. 测试数据库连接
-
-```bash
-npm test
-```
-
-如果看到 ✅ 连接成功，说明配置正确。
-
-### 3. 启动MCP服务器
-
-```bash
-npm start
-```
-
-## 🔧 在Augment中配置
-
-### 找到Augment配置文件
-
-- **Windows**: `%APPDATA%\Augment\config.json`
-- **macOS**: `~/Library/Application Support/Augment/config.json`
-- **Linux**: `~/.config/Augment/config.json`
-
-### 添加MCP服务器配置
-
-在配置文件中添加：
-
-```json
-{
-  "mcpServers": {
-    "vmoo-database": {
-      "command": "node",
-      "args": ["D:\\代码库\\vmoo-mcp-server\\mcp-vmoo-database-server.js"],
-      "env": {}
-    }
-  }
-}
-```
-
-**注意**: 请将路径替换为你的实际路径。
-
-### 重启Augment
-
-保存配置文件后，重启Augment应用。
-
-## 🛠️ 可用工具
-
-配置成功后，你可以在Augment中直接询问：
-
-### 1. 查询数据库
-- "列出所有fanwe_开头的表"
-- "查询最近注册的10个用户"
-- "显示fanwe_menu表中价格最高的商品"
-
-### 2. 查看表结构
-- "fanwe_user表的结构是什么？"
-- "描述fanwe_order表的字段"
-
-### 3. 获取示例数据
-- "显示fanwe_menu表的前5条记录"
-- "fanwe_user表的示例数据"
-
-### 4. 统计信息
-- "fanwe_user表有多少条记录？"
-- "数据库中有多少个表？"
-
-## 📊 数据库信息
-
-- **主机**: 118.25.190.11:3306
-- **数据库**: ceshi_v_moo_com
-- **表前缀**: fanwe_
-- **字符集**: utf8mb4
-
-## 🔒 安全特性
-
-### 允许的操作
-- **查询操作**: SELECT、SHOW、DESCRIBE、EXPLAIN
-- **数据修改**: INSERT、UPDATE（仅限新增和修改）
-- **表结构**: CREATE TABLE、ALTER TABLE
-
-### 安全防护
-- **禁止所有删除操作**: 完全阻止DELETE、DROP TABLE、DROP DATABASE等删除操作
-- **测试环境专用**: 专为测试环境设计，确保数据安全
-- **查询限制**: 自动添加LIMIT防止大量数据返回
-- **SQL注入防护**: 使用参数化查询
-- **连接池管理**: 自动管理数据库连接
-- **错误处理**: 完善的错误捕获和提示
-
-## 📝 使用示例
-
-```
-用户: "VMOO数据库中有哪些用户相关的表？"
-AI: 调用list_tables工具，返回包含user的表列表
-
-用户: "fanwe_user表的字段都有什么含义？"
-AI: 调用describe_table工具，返回表结构详情
-
-用户: "最近一周注册的用户有多少？"
-AI: 调用query_database工具，执行相应SQL查询
-```
-
-## 🛠️ 开发调试
-
-### 启用调试模式
-
-```bash
-npm run dev
-```
-
-这将启用Node.js调试器，可以在Chrome DevTools中调试。
-
-### 查看日志
-
-MCP服务器的日志会输出到stderr，可以通过以下方式查看：
-
-```bash
-node mcp-vmoo-database-server.js 2> debug.log
-```
-
-## 🔧 故障排除
-
-### 连接问题
-- 检查网络连接
-- 确认数据库服务器可访问
-- 验证防火墙设置
-
-### 权限问题
-- 确保数据库用户有查询权限
-- 检查表访问权限
-
-### 配置问题
-- 验证Augment配置文件路径正确
-- 确保Node.js版本 >= 18.0.0
-
-## 📄 许可证
-
-MIT License
+# vmoo-mcp-database-server
+
+VMOO数据库MCP服务器 - 支持开发和生产环境的安全数据库访问
+
+[![npm version](https://badge.fury.io/js/vmoo-mcp-database-server.svg)](https://badge.fury.io/js/vmoo-mcp-database-server)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## 🚀 快速开始
+
+### 使用npx直接运行（推荐）
+
+```bash
+# 开发环境
+npx vmoo-mcp-database-server@latest --env=dev
+
+# 生产环境
+npx vmoo-mcp-database-server@latest --env=prod
+```
+
+### 在Augment中配置
+
+```json
+{
+  "mcpServers": {
+    "vmoo-database-dev": {
+      "command": "npx",
+      "args": ["vmoo-mcp-database-server@latest", "--env=dev"],
+      "env": {
+        "V_MOO_PASSWORD": "xxxxxxxxxxxxx"
+      }
+    },
+    "vmoo-database-prod": {
+      "command": "npx",
+      "args": ["vmoo-mcp-database-server@latest", "--env=prod"],
+      "env": {
+        "V_MOO_PASSWORD": "xxxxxxxxxxxxx"
+      }
+    },
+    "vmoo-database-deliver": {
+      "command": "npx",
+      "args": ["vmoo-mcp-database-server@latest", "--env=deliver"],
+      "env": {
+        "DELIVER_PASSWORD": "xxxxxxxxxxxxx"
+      }
+    }
+  }
+}
+```
+
+### 1. 安装依赖
+
+```bash
+npm install
+```
+
+### 2. 测试数据库连接
+
+```bash
+npm test
+```
+
+如果看到 ✅ 连接成功，说明配置正确。
+
+### 3. 启动MCP服务器
+
+```bash
+npm start
+```
+
+## 🔧 在Augment中配置
+
+### 找到Augment配置文件
+
+- **Windows**: `%APPDATA%\Augment\config.json`
+- **macOS**: `~/Library/Application Support/Augment/config.json`
+- **Linux**: `~/.config/Augment/config.json`
+
+### 添加MCP服务器配置
+
+在配置文件中添加：
+
+```json
+{
+  "mcpServers": {
+    "vmoo-database-dev": {
+      "command": "node",
+      "args": ["D:\\代码库\\vmoo-mcp-server\\bin\\vmoo-mcp-dev.js"],
+      "env": {
+        "V_MOO_PASSWORD": "xxxxxxxxxxxxx"
+      }
+    },
+    "vmoo-database-prod": {
+      "command": "node",
+      "args": ["D:\\代码库\\vmoo-mcp-server\\bin\\vmoo-mcp-prod.js"],
+      "env": {
+        "V_MOO_PASSWORD": "xxxxxxxxxxxxx"
+      }
+    },
+    "vmoo-database-deliver": {
+      "command": "node",
+      "args": ["D:\\代码库\\vmoo-mcp-server\\bin\\vmoo-mcp-deliver.js"],
+      "env": {
+        "DELIVER_PASSWORD": "xxxxxxxxxxxxx"
+      }
+    }
+  }
+}
+```
+
+**注意**: 请将路径替换为你的实际路径。
+
+### 重启Augment
+
+保存配置文件后，重启Augment应用。
+
+## 🛠️ 可用工具
+
+配置成功后，你可以在Augment中直接询问：
+
+### 1. 查询数据库
+- "列出所有fanwe_开头的表"
+- "查询最近注册的10个用户"
+- "显示fanwe_menu表中价格最高的商品"
+
+### 2. 查看表结构
+- "fanwe_user表的结构是什么？"
+- "描述fanwe_order表的字段"
+
+### 3. 获取示例数据
+- "显示fanwe_menu表的前5条记录"
+- "fanwe_user表的示例数据"
+
+### 4. 统计信息
+- "fanwe_user表有多少条记录？"
+- "数据库中有多少个表？"
+
+## 📊 数据库信息
+
+### 开发环境 (dev) 和生产环境 (prod)
+- **主机**: 118.25.190.11:3306
+- **数据库**: ceshi_v_moo_com
+- **用户**: ceshi_v_moo_com
+- **字符集**: utf8mb4
+
+### 配送测试站 (deliver)
+- **主机**: 118.25.190.11:3306
+- **数据库**: ceshi_deliver
+- **用户**: ceshi_deliver
+- **字符集**: utf8mb4
+
+## 🔒 安全特性
+
+### 允许的操作
+- **查询操作**: SELECT、SHOW、DESCRIBE、EXPLAIN
+- **数据修改**: INSERT、UPDATE（仅限新增和修改）
+- **表结构**: CREATE TABLE、ALTER TABLE
+
+### 安全防护
+- **禁止所有删除操作**: 完全阻止DELETE、DROP TABLE、DROP DATABASE等删除操作
+- **测试环境专用**: 专为测试环境设计，确保数据安全
+- **查询限制**: 自动添加LIMIT防止大量数据返回
+- **SQL注入防护**: 使用参数化查询
+- **连接池管理**: 自动管理数据库连接
+- **错误处理**: 完善的错误捕获和提示
+
+## 📝 使用示例
+
+```
+用户: "VMOO数据库中有哪些用户相关的表？"
+AI: 调用list_tables工具，返回包含user的表列表
+
+用户: "fanwe_user表的字段都有什么含义？"
+AI: 调用describe_table工具，返回表结构详情
+
+用户: "最近一周注册的用户有多少？"
+AI: 调用query_database工具，执行相应SQL查询
+```
+
+## 🛠️ 开发调试
+
+### 启用调试模式
+
+```bash
+npm run dev
+```
+
+这将启用Node.js调试器，可以在Chrome DevTools中调试。
+
+### 查看日志
+
+MCP服务器的日志会输出到stderr，可以通过以下方式查看：
+
+```bash
+node mcp-vmoo-database-server.js 2> debug.log
+```
+
+## 🔧 故障排除
+
+### 连接问题
+- 检查网络连接
+- 确认数据库服务器可访问
+- 验证防火墙设置
+
+### 权限问题
+- 确保数据库用户有查询权限
+- 检查表访问权限
+
+### 配置问题
+- 验证Augment配置文件路径正确
+- 确保Node.js版本 >= 18.0.0
+
+## 📄 许可证
+
+MIT License

package/bin/vmoo-mcp-deliver.js

@@ -1,45 +1,45 @@
-#!/usr/bin/env node
-
-// VMOO配送测试站MCP服务器启动器
-
-import { spawn } from 'child_process';
-import { fileURLToPath } from 'url';
-import path from 'path';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-// 解析命令行参数
-const args = process.argv.slice(2);
-const configPath = args.find(arg => arg.startsWith('--config='))?.split('=')[1];
-
-console.log('🚚 启动VMOO配送测试站MCP服务器...');
-
-// 服务器文件路径
-const serverPath = path.join(__dirname, '../vmoo-database-deliver/server.js');
-
-// 启动服务器
-const serverProcess = spawn('node', [serverPath], {
-  stdio: 'inherit',
-  env: {
-    ...process.env,
-    ...(configPath && { CONFIG_PATH: configPath })
-  }
-});
-
-// 处理进程退出
-serverProcess.on('close', (code) => {
-  console.log(`🚚 配送测试站MCP服务器已退出，退出码: ${code}`);
-  process.exit(code);
-});
-
-// 处理中断信号
-process.on('SIGINT', () => {
-  console.log('\n🛑 正在关闭配送测试站MCP服务器...');
-  serverProcess.kill('SIGINT');
-});
-
-process.on('SIGTERM', () => {
-  console.log('\n🛑 正在关闭配送测试站MCP服务器...');
-  serverProcess.kill('SIGTERM');
-});
+#!/usr/bin/env node
+
+// VMOO配送测试站MCP服务器启动器
+
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+import path from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// 解析命令行参数
+const args = process.argv.slice(2);
+const configPath = args.find(arg => arg.startsWith('--config='))?.split('=')[1];
+
+console.log('🚚 启动VMOO配送测试站MCP服务器...');
+
+// 服务器文件路径
+const serverPath = path.join(__dirname, '../vmoo-database-deliver/server.js');
+
+// 启动服务器
+const serverProcess = spawn('node', [serverPath], {
+  stdio: 'inherit',
+  env: {
+    ...process.env,
+    ...(configPath && { CONFIG_PATH: configPath })
+  }
+});
+
+// 处理进程退出
+serverProcess.on('close', (code) => {
+  console.log(`🚚 配送测试站MCP服务器已退出，退出码: ${code}`);
+  process.exit(code);
+});
+
+// 处理中断信号
+process.on('SIGINT', () => {
+  console.log('\n🛑 正在关闭配送测试站MCP服务器...');
+  serverProcess.kill('SIGINT');
+});
+
+process.on('SIGTERM', () => {
+  console.log('\n🛑 正在关闭配送测试站MCP服务器...');
+  serverProcess.kill('SIGTERM');
+});

package/bin/vmoo-mcp-dev.js

@@ -1,45 +1,45 @@
-#!/usr/bin/env node
-
-// VMOO开发环境MCP服务器启动器
-
-import { spawn } from 'child_process';
-import { fileURLToPath } from 'url';
-import path from 'path';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-// 解析命令行参数
-const args = process.argv.slice(2);
-const configPath = args.find(arg => arg.startsWith('--config='))?.split('=')[1];
-
-console.log('🟡 启动VMOO开发环境MCP服务器...');
-
-// 服务器文件路径
-const serverPath = path.join(__dirname, '../vmoo-database-dev/server.js');
-
-// 启动服务器
-const serverProcess = spawn('node', [serverPath], {
-  stdio: 'inherit',
-  env: {
-    ...process.env,
-    ...(configPath && { CONFIG_PATH: configPath })
-  }
-});
-
-// 处理进程退出
-serverProcess.on('close', (code) => {
-  console.log(`🟡 开发环境MCP服务器已退出，退出码: ${code}`);
-  process.exit(code);
-});
-
-// 处理中断信号
-process.on('SIGINT', () => {
-  console.log('\n🛑 正在关闭开发环境MCP服务器...');
-  serverProcess.kill('SIGINT');
-});
-
-process.on('SIGTERM', () => {
-  console.log('\n🛑 正在关闭开发环境MCP服务器...');
-  serverProcess.kill('SIGTERM');
-});
+#!/usr/bin/env node
+
+// VMOO开发环境MCP服务器启动器
+
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+import path from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// 解析命令行参数
+const args = process.argv.slice(2);
+const configPath = args.find(arg => arg.startsWith('--config='))?.split('=')[1];
+
+console.log('🟡 启动VMOO开发环境MCP服务器...');
+
+// 服务器文件路径
+const serverPath = path.join(__dirname, '../vmoo-database-dev/server.js');
+
+// 启动服务器
+const serverProcess = spawn('node', [serverPath], {
+  stdio: 'inherit',
+  env: {
+    ...process.env,
+    ...(configPath && { CONFIG_PATH: configPath })
+  }
+});
+
+// 处理进程退出
+serverProcess.on('close', (code) => {
+  console.log(`🟡 开发环境MCP服务器已退出，退出码: ${code}`);
+  process.exit(code);
+});
+
+// 处理中断信号
+process.on('SIGINT', () => {
+  console.log('\n🛑 正在关闭开发环境MCP服务器...');
+  serverProcess.kill('SIGINT');
+});
+
+process.on('SIGTERM', () => {
+  console.log('\n🛑 正在关闭开发环境MCP服务器...');
+  serverProcess.kill('SIGTERM');
+});

package/bin/vmoo-mcp-prod.js

@@ -1,45 +1,45 @@
-#!/usr/bin/env node
-
-// VMOO生产环境MCP服务器启动器
-
-import { spawn } from 'child_process';
-import { fileURLToPath } from 'url';
-import path from 'path';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-// 解析命令行参数
-const args = process.argv.slice(2);
-const configPath = args.find(arg => arg.startsWith('--config='))?.split('=')[1];
-
-console.log('🔴 启动VMOO生产环境MCP服务器...');
-
-// 服务器文件路径
-const serverPath = path.join(__dirname, '../vmoo-database-prod/server.js');
-
-// 启动服务器
-const serverProcess = spawn('node', [serverPath], {
-  stdio: 'inherit',
-  env: {
-    ...process.env,
-    ...(configPath && { CONFIG_PATH: configPath })
-  }
-});
-
-// 处理进程退出
-serverProcess.on('close', (code) => {
-  console.log(`🔴 生产环境MCP服务器已退出，退出码: ${code}`);
-  process.exit(code);
-});
-
-// 处理中断信号
-process.on('SIGINT', () => {
-  console.log('\n🛑 正在关闭生产环境MCP服务器...');
-  serverProcess.kill('SIGINT');
-});
-
-process.on('SIGTERM', () => {
-  console.log('\n🛑 正在关闭生产环境MCP服务器...');
-  serverProcess.kill('SIGTERM');
-});
+#!/usr/bin/env node
+
+// VMOO生产环境MCP服务器启动器
+
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+import path from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// 解析命令行参数
+const args = process.argv.slice(2);
+const configPath = args.find(arg => arg.startsWith('--config='))?.split('=')[1];
+
+console.log('🔴 启动VMOO生产环境MCP服务器...');
+
+// 服务器文件路径
+const serverPath = path.join(__dirname, '../vmoo-database-prod/server.js');
+
+// 启动服务器
+const serverProcess = spawn('node', [serverPath], {
+  stdio: 'inherit',
+  env: {
+    ...process.env,
+    ...(configPath && { CONFIG_PATH: configPath })
+  }
+});
+
+// 处理进程退出
+serverProcess.on('close', (code) => {
+  console.log(`🔴 生产环境MCP服务器已退出，退出码: ${code}`);
+  process.exit(code);
+});
+
+// 处理中断信号
+process.on('SIGINT', () => {
+  console.log('\n🛑 正在关闭生产环境MCP服务器...');
+  serverProcess.kill('SIGINT');
+});
+
+process.on('SIGTERM', () => {
+  console.log('\n🛑 正在关闭生产环境MCP服务器...');
+  serverProcess.kill('SIGTERM');
+});