@cmd233/mcp-database-server 1.1.1 → 1.1.3

package/dist/src/index.js

@@ -2,19 +2,19 @@
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-// Import database utils
+// 导入数据库工具模块
 import { initDatabase, closeDatabase, getDatabaseMetadata } from './db/index.js';
-// Import handlers
+// 导入处理器
 import { handleListResources, handleReadResource } from './handlers/resourceHandlers.js';
 import { handleListTools, handleToolCall } from './handlers/toolHandlers.js';
-// Setup a logger that uses stderr instead of stdout to avoid interfering with MCP communications
+// 设置使用 stderr 而不是 stdout 的日志记录器,避免干扰 MCP 通信
 const logger = {
     log: (...args) => console.error('[INFO]', ...args),
     error: (...args) => console.error('[ERROR]', ...args),
     warn: (...args) => console.error('[WARN]', ...args),
     info: (...args) => console.error('[INFO]', ...args),
 };
-// Configure the server
+// 配置服务器
 const server = new Server({
     name: "executeautomation/database-server",
     version: "1.1.0",
@@ -24,7 +24,7 @@ const server = new Server({
         tools: {},
     },
 });
-// Parse command line arguments
+// 解析命令行参数
 const args = process.argv.slice(2);
 if (args.length === 0) {
     logger.error("Please provide database connection information");
@@ -35,10 +35,10 @@ if (args.length === 0) {
     logger.error("Usage for MySQL with AWS IAM: node index.js --mysql --aws-iam-auth --host <rds-endpoint> --database <database> --user <aws-username> --aws-region <region>");
     process.exit(1);
 }
-// Parse arguments to determine database type and connection info
+// 解析参数以确定数据库类型和连接信息
 let dbType = 'sqlite';
 let connectionInfo = null;
-// Check if using SQL Server
+// 检查是否使用 SQL Server
 if (args.includes('--sqlserver')) {
     dbType = 'sqlserver';
     connectionInfo = {
@@ -47,7 +47,7 @@ if (args.includes('--sqlserver')) {
         user: undefined,
         password: undefined
     };
-    // Parse SQL Server connection parameters
+    // 解析 SQL Server 连接参数
     for (let i = 0; i < args.length; i++) {
         if (args[i] === '--server' && i + 1 < args.length) {
             connectionInfo.server = args[i + 1];
@@ -65,13 +65,13 @@ if (args.includes('--sqlserver')) {
             connectionInfo.port = parseInt(args[i + 1], 10);
         }
     }
-    // Validate SQL Server connection info
+    // 验证 SQL Server 连接信息
     if (!connectionInfo.server || !connectionInfo.database) {
         logger.error("Error: SQL Server requires --server and --database parameters");
         process.exit(1);
     }
 }
-// Check if using PostgreSQL
+// 检查是否使用 PostgreSQL
 else if (args.includes('--postgresql') || args.includes('--postgres')) {
     dbType = 'postgresql';
     connectionInfo = {
@@ -83,7 +83,7 @@ else if (args.includes('--postgresql') || args.includes('--postgres')) {
         ssl: undefined,
         connectionTimeout: undefined
     };
-    // Parse PostgreSQL connection parameters
+    // 解析 PostgreSQL 连接参数
     for (let i = 0; i < args.length; i++) {
         if (args[i] === '--host' && i + 1 < args.length) {
             connectionInfo.host = args[i + 1];
@@ -107,13 +107,13 @@ else if (args.includes('--postgresql') || args.includes('--postgres')) {
             connectionInfo.connectionTimeout = parseInt(args[i + 1], 10);
         }
     }
-    // Validate PostgreSQL connection info
+    // 验证 PostgreSQL 连接信息
     if (!connectionInfo.host || !connectionInfo.database) {
         logger.error("Error: PostgreSQL requires --host and --database parameters");
         process.exit(1);
     }
 }
-// Check if using MySQL
+// 检查是否使用 MySQL
 else if (args.includes('--mysql')) {
     dbType = 'mysql';
     connectionInfo = {
@@ -127,7 +127,7 @@ else if (args.includes('--mysql')) {
         awsIamAuth: false,
         awsRegion: undefined
     };
-    // Parse MySQL connection parameters
+    // 解析 MySQL 连接参数
     for (let i = 0; i < args.length; i++) {
         if (args[i] === '--host' && i + 1 < args.length) {
             connectionInfo.host = args[i + 1];
@@ -163,12 +163,12 @@ else if (args.includes('--mysql')) {
             connectionInfo.awsRegion = args[i + 1];
         }
     }
-    // Validate MySQL connection info
+    // 验证 MySQL 连接信息
     if (!connectionInfo.host || !connectionInfo.database) {
         logger.error("Error: MySQL requires --host and --database parameters");
         process.exit(1);
     }
-    // Additional validation for AWS IAM authentication
+    // AWS IAM 认证的额外验证
     if (connectionInfo.awsIamAuth) {
         if (!connectionInfo.user) {
             logger.error("Error: AWS IAM authentication requires --user parameter");
@@ -178,18 +178,18 @@ else if (args.includes('--mysql')) {
             logger.error("Error: AWS IAM authentication requires --aws-region parameter");
             process.exit(1);
         }
-        // Automatically enable SSL for AWS IAM authentication (required)
+        // 为 AWS IAM 认证自动启用 SSL (必需)
         connectionInfo.ssl = true;
         logger.info("AWS IAM authentication enabled - SSL automatically configured");
     }
 }
 else {
-    // SQLite mode (default)
+    // SQLite 模式(默认)
     dbType = 'sqlite';
-    connectionInfo = args[0]; // First argument is the SQLite file path
+    connectionInfo = args[0]; // 第一个参数是 SQLite 文件路径
     logger.info(`Using SQLite database at path: ${connectionInfo}`);
 }
-// Set up request handlers
+// 设置请求处理器
 server.setRequestHandler(ListResourcesRequestSchema, async () => {
     return await handleListResources();
 });
@@ -202,7 +202,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
     return await handleToolCall(request.params.name, request.params.arguments);
 });
-// Handle shutdown gracefully
+// 优雅处理关闭信号
 process.on('SIGINT', async () => {
     logger.info('Shutting down gracefully...');
     await closeDatabase();
@@ -213,7 +213,7 @@ process.on('SIGTERM', async () => {
     await closeDatabase();
     process.exit(0);
 });
-// Add global error handler
+// 添加全局错误处理器
 process.on('uncaughtException', (error) => {
     logger.error('Uncaught exception:', error);
 });
@@ -221,7 +221,7 @@ process.on('unhandledRejection', (reason, promise) => {
     logger.error('Unhandled Rejection at:', promise, 'reason:', reason);
 });
 /**
- * Start the server
+ * 启动服务器
  */
 async function runServer() {
     try {
@@ -238,7 +238,7 @@ async function runServer() {
         else if (dbType === 'mysql') {
             logger.info(`Host: ${connectionInfo.host}, Database: ${connectionInfo.database}`);
         }
-        // Initialize the database
+        // 初始化数据库
         await initDatabase(connectionInfo, dbType);
         const dbInfo = getDatabaseMetadata();
         logger.info(`Connected to ${dbInfo.name} database`);
@@ -252,7 +252,7 @@ async function runServer() {
         process.exit(1);
     }
 }
-// Start the server
+// 启动服务器
 runServer().catch(error => {
     logger.error("Server initialization failed:", error);
     process.exit(1);

package/dist/src/tools/insightTools.js

@@ -1,16 +1,16 @@
 import { dbAll, dbExec, dbRun } from '../db/index.js';
 import { formatSuccessResponse } from '../utils/formatUtils.js';
 /**
- * Add a business insight to the memo
- * @param insight Business insight text
- * @returns Result of the operation
+ * 添加业务洞察到备忘录
+ * @param insight 业务洞察文本
+ * @returns 操作结果
  */
 export async function appendInsight(insight) {
     try {
         if (!insight) {
             throw new Error("Insight text is required");
         }
-        // Create insights table if it doesn't exist
+        // 如果 insights 表不存在则创建
         await dbExec(`
       CREATE TABLE IF NOT EXISTS mcp_insights (
         id INTEGER PRIMARY KEY AUTOINCREMENT,
@@ -18,7 +18,7 @@ export async function appendInsight(insight) {
         created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
       )
     `);
-        // Insert the insight
+        // 插入洞察记录
         await dbRun("INSERT INTO mcp_insights (insight) VALUES (?)", [insight]);
         return formatSuccessResponse({ success: true, message: "Insight added" });
     }
@@ -27,15 +27,15 @@ export async function appendInsight(insight) {
     }
 }
 /**
- * List all insights in the memo
- * @returns Array of insights
+ * 列出备忘录中的所有洞察
+ * @returns 洞察数组
  */
 export async function listInsights() {
     try {
-        // Check if insights table exists
+        // 检查 insights 表是否存在
         const tableExists = await dbAll("SELECT name FROM sqlite_master WHERE type='table' AND name = 'mcp_insights'");
         if (tableExists.length === 0) {
-            // Create table if it doesn't exist
+            // 如果表不存在则创建
             await dbExec(`
         CREATE TABLE IF NOT EXISTS mcp_insights (
           id INTEGER PRIMARY KEY AUTOINCREMENT,

package/dist/src/tools/queryTools.js

@@ -1,9 +1,9 @@
 import { dbAll, dbRun } from '../db/index.js';
 import { formatSuccessResponse, convertToCSV } from '../utils/formatUtils.js';
 /**
- * Execute a read-only SQL query
- * @param query SQL query to execute
- * @returns Query results
+ * 执行只读 SQL 查询
+ * @param query 要执行的 SQL 查询
+ * @returns 查询结果
  */
 export async function readQuery(query) {
     try {
@@ -18,9 +18,9 @@ export async function readQuery(query) {
     }
 }
 /**
- * Execute a data modification SQL query
- * @param query SQL query to execute
- * @returns Information about affected rows
+ * 执行数据修改 SQL 查询
+ * @param query 要执行的 SQL 查询
+ * @returns 受影响行的信息
  */
 export async function writeQuery(query) {
     try {
@@ -39,10 +39,10 @@ export async function writeQuery(query) {
     }
 }
 /**
- * Export query results to CSV or JSON format
- * @param query SQL query to execute
- * @param format Output format (csv or json)
- * @returns Formatted query results
+ * 将查询结果导出为 CSV 或 JSON 格式
+ * @param query 要执行的 SQL 查询
+ * @param format 输出格式(csv 或 json)
+ * @returns 格式化的查询结果
  */
 export async function exportQuery(query, format) {
     try {

package/dist/src/tools/schemaTools.js

@@ -1,9 +1,9 @@
 import { dbAll, dbExec, getListTablesQuery, getDescribeTableQuery } from '../db/index.js';
 import { formatSuccessResponse } from '../utils/formatUtils.js';
 /**
- * Create a new table in the database
- * @param query CREATE TABLE SQL statement
- * @returns Result of the operation
+ * 在数据库中创建新表
+ * @param query CREATE TABLE SQL 语句
+ * @returns 操作结果
  */
 export async function createTable(query) {
     try {
@@ -18,9 +18,9 @@ export async function createTable(query) {
     }
 }
 /**
- * Alter an existing table schema
- * @param query ALTER TABLE SQL statement
- * @returns Result of the operation
+ * 修改现有表的结构
+ * @param query ALTER TABLE SQL 语句
+ * @returns 操作结果
  */
 export async function alterTable(query) {
     try {
@@ -35,10 +35,10 @@ export async function alterTable(query) {
     }
 }
 /**
- * Drop a table from the database
- * @param tableName Name of the table to drop
- * @param confirm Safety confirmation flag
- * @returns Result of the operation
+ * 从数据库中删除表
+ * @param tableName 要删除的表名
+ * @param confirm 安全确认标志
+ * @returns 操作结果
  */
 export async function dropTable(tableName, confirm) {
     try {
@@ -70,8 +70,8 @@ export async function dropTable(tableName, confirm) {
     }
 }
 /**
- * List all tables in the database
- * @returns Array of table names
+ * 列出数据库中的所有表
+ * @returns 表名数组
  */
 export async function listTables() {
     try {
@@ -85,9 +85,9 @@ export async function listTables() {
     }
 }
 /**
- * Get schema information for a specific table
- * @param tableName Name of the table to describe
- * @returns Column definitions for the table
+ * 获取指定表的结构信息
+ * @param tableName 要描述的表名
+ * @returns 表的列定义
  */
 export async function describeTable(tableName) {
     try {

package/dist/src/utils/formatUtils.js

@@ -1,24 +1,24 @@
 /**
- * Convert data to CSV format
- * @param data Array of objects to convert to CSV
- * @returns CSV formatted string
+ * 将数据转换为 CSV 格式
+ * @param data 要转换为 CSV 的对象数组
+ * @returns CSV 格式的字符串
  */
 export function convertToCSV(data) {
     if (data.length === 0)
         return '';
-    // Get headers
+    // 获取表头
     const headers = Object.keys(data[0]);
-    // Create CSV header row
+    // 创建 CSV 表头行
     let csv = headers.join(',') + '\n';
-    // Add data rows
+    // 添加数据行
     data.forEach(row => {
         const values = headers.map(header => {
             const val = row[header];
-            // Handle strings with commas, quotes, etc.
+            // 处理包含逗号、引号等的字符串
             if (typeof val === 'string') {
                 return `"${val.replace(/"/g, '""')}"`;
             }
-            // Use empty string for null/undefined
+            // 对于 null/undefined 使用空字符串
             return val === null || val === undefined ? '' : val;
         });
         csv += values.join(',') + '\n';
@@ -26,9 +26,9 @@ export function convertToCSV(data) {
     return csv;
 }
 /**
- * Format error response
- * @param error Error object or message
- * @returns Formatted error response object
+ * 格式化错误响应
+ * @param error 错误对象或错误消息
+ * @returns 格式化的错误响应对象
  */
 export function formatErrorResponse(error) {
     const message = error instanceof Error ? error.message : error;
@@ -41,9 +41,9 @@ export function formatErrorResponse(error) {
     };
 }
 /**
- * Format success response
- * @param data Data to format
- * @returns Formatted success response object
+ * 格式化成功响应
+ * @param data 要格式化的数据
+ * @returns 格式化的成功响应对象
  */
 export function formatSuccessResponse(data) {
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cmd233/mcp-database-server",
-    "version": "1.1.1",
+    "version": "1.1.3",
     "description": "MCP server for interacting with SQLite, SQL Server, PostgreSQL and MySQL databases (Fixed nullable field detection)",
     "license": "MIT",
     "author": "cmd233",
@@ -8,7 +8,8 @@
     "bugs": "https://github.com/cmd233/mcp-database-server/issues",
     "type": "module",
     "bin": {
-        "ea-database-server": "dist/src/index.js"
+        "ea-database-server": "dist/src/index.js",
+        "mcp-database-server": "dist/src/index.js"
     },
     "files": [
         "dist"