@cemalturkcann/mariadb-mcp-server 1.1.1 → 1.1.3

package/README.md

@@ -96,6 +96,8 @@ Example config:
 
 ## MCP Client Setup
 
+On first run, a default config is created automatically at `~/.config/mariadb-mcp/config.json` (Linux/macOS) or `%APPDATA%\mariadb-mcp\config.json` (Windows). Edit it to add your connections.
+
 ### Claude Code
 
 Add to `~/.claude.json`:
@@ -105,10 +107,7 @@ Add to `~/.claude.json`:
   "mcpServers": {
     "mariadb": {
       "command": "npx",
-      "args": ["-y", "@cemalturkcann/mariadb-mcp-server"],
-      "env": {
-        "DB_MCP_CONFIG_PATH": "/path/to/config.json"
-      }
+      "args": ["-y", "@cemalturkcann/mariadb-mcp-server"]
     }
   }
 }
@@ -123,10 +122,7 @@ Add to your `opencode.json`:
   "mcp": {
     "mariadb": {
       "type": "local",
-      "command": ["npx", "-y", "@cemalturkcann/mariadb-mcp-server"],
-      "environment": {
-        "DB_MCP_CONFIG_PATH": "/path/to/config.json"
-      }
+      "command": ["npx", "-y", "@cemalturkcann/mariadb-mcp-server"]
     }
   }
 }
@@ -134,7 +130,7 @@ Add to your `opencode.json`:
 
 ### Other MCP Clients
 
-Any MCP-compatible client can use this server. The binary name is `mariadb-mcp-server` and it communicates over stdio. Point `DB_MCP_CONFIG_PATH` to your config file.
+Any MCP-compatible client can use this server. The binary name is `mariadb-mcp-server` and it communicates over stdio. To use a custom config path, set `DB_MCP_CONFIG_PATH`.
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cemalturkcann/mariadb-mcp-server",
-  "version": "1.1.1",
+  "version": "1.1.3",
   "description": "MCP server for MariaDB/MySQL with per-connection read/write access control",
   "type": "module",
   "main": "src/index.js",

package/src/config.js

@@ -99,19 +99,19 @@ export function loadConfig() {
   const raw = rawConfig.connections || rawConfig.databases;
   if (!raw || typeof raw !== "object") {
     throw new Error(
-      "config.json icinde 'connections' (veya eski format 'databases') nesnesi olmalidir.",
+      "config.json must contain a 'connections' (or legacy 'databases') object.",
     );
   }
 
   const entries = Object.entries(raw);
   if (entries.length === 0) {
-    throw new Error("En az bir baglanti tanimlamalisiniz.");
+    throw new Error("You must define at least one connection.");
   }
 
   const connections = {};
   for (const [name, connection] of entries) {
     if (!connection || typeof connection !== "object") {
-      throw new Error(`'${name}' baglantisi gecersiz.`);
+      throw new Error(`'${name}' connection is invalid.`);
     }
 
     const normalized = normalizeConnection(connection);
@@ -122,7 +122,7 @@ export function loadConfig() {
       normalized.default_row_limit > normalized.max_row_limit
     ) {
       throw new Error(
-        `'${name}' icin default_row_limit, max_row_limit degerinden buyuk olamaz.`,
+        `default_row_limit for '${name}' cannot exceed max_row_limit.`,
       );
     }
 

package/src/db.js

@@ -1,4 +1,4 @@
-import mariadb from "mariadb";
+import { createPool } from "mariadb";
 
 export class DbManager {
   constructor(config) {
@@ -12,13 +12,13 @@ export class DbManager {
 
   getReadableConnections() {
     return this.getConnectionNames().filter(
-      (name) => this.config.connections[name].read
+      (name) => this.config.connections[name].read,
     );
   }
 
   getWritableConnections() {
     return this.getConnectionNames().filter(
-      (name) => this.config.connections[name].write
+      (name) => this.config.connections[name].write,
     );
   }
 
@@ -27,7 +27,7 @@ export class DbManager {
     if (!cfg) {
       const available = this.getConnectionNames().join(", ");
       throw new Error(
-        `Baglanti bulunamadi: '${name}'. Mevcut baglantilar: ${available}`
+        `Connection not found: '${name}'. Available connections: ${available}`,
       );
     }
     return cfg;
@@ -59,7 +59,7 @@ export class DbManager {
           typeof c.ssl === "object" ? c.ssl : { rejectUnauthorized: false };
       }
 
-      this.pools.set(poolKey, mariadb.createPool(poolOptions));
+      this.pools.set(poolKey, createPool(poolOptions));
     }
 
     return this.pools.get(poolKey);
@@ -69,7 +69,7 @@ export class DbManager {
     const cfg = this.getConnectionConfig(connectionName);
     if (!cfg.read) {
       throw new Error(
-        `'${connectionName}' baglantisi read (okuma) izni vermiyor.`
+        `'${connectionName}' connection does not allow read access.`,
       );
     }
   }
@@ -78,7 +78,7 @@ export class DbManager {
     const cfg = this.getConnectionConfig(connectionName);
     if (!cfg.write) {
       throw new Error(
-        `'${connectionName}' baglantisi write (yazma) izni vermiyor.`
+        `'${connectionName}' connection does not allow write access.`,
       );
     }
   }
@@ -131,10 +131,10 @@ export class DbManager {
       try {
         await conn.rollback();
       } catch {
-        /* asil hatayi koruyoruz */
+        /* preserve the original error */
       }
       throw new Error(
-        `Transaction basarisiz, rollback yapildi: ${error.message}`
+        `Transaction failed, rolled back: ${error.message}`,
       );
     } finally {
       conn.release();

package/src/index.js

@@ -66,14 +66,14 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
       case "list_databases": {
         const connection = args?.connection;
-        if (!connection) return fail("'connection' alani zorunludur.");
+        if (!connection) return fail("'connection' field is required.");
         const rows = await db.runReadOnly(connection, "SHOW DATABASES");
         return ok(rows);
       }
 
       case "list_tables": {
         const { connection, database } = args || {};
-        if (!connection) return fail("'connection' alani zorunludur.");
+        if (!connection) return fail("'connection' field is required.");
         const sql = database
           ? `SHOW TABLES FROM \`${database}\``
           : "SHOW TABLES";
@@ -83,8 +83,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
       case "describe_table": {
         const { connection, table, database } = args || {};
-        if (!connection) return fail("'connection' alani zorunludur.");
-        if (!table) return fail("'table' alani zorunludur.");
+        if (!connection) return fail("'connection' field is required.");
+        if (!table) return fail("'table' field is required.");
         const path = database ? `\`${database}\`.\`${table}\`` : `\`${table}\``;
         const rows = await db.runReadOnly(connection, `DESCRIBE ${path}`);
         return ok(rows);
@@ -96,8 +96,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         const database = args?.database;
         const requestedRowLimit = args?.row_limit;
 
-        if (!connection) return fail("'connection' alani zorunludur.");
-        if (!query) return fail("'query' alani zorunludur.");
+        if (!connection) return fail("'connection' field is required.");
+        if (!query) return fail("'query' field is required.");
 
         const connectionConfig = db.getConnectionConfig(connection);
         const validatedQuery = validateReadQuery(query);
@@ -130,8 +130,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
       case "execute_write": {
         const { connection, query } = args || {};
-        if (!connection) return fail("'connection' alani zorunludur.");
-        if (!query) return fail("'query' alani zorunludur.");
+        if (!connection) return fail("'connection' field is required.");
+        if (!query) return fail("'query' field is required.");
 
         const validatedQuery = validateWriteQuery(query);
         const meta = await db.runWrite(connection, validatedQuery);
@@ -140,9 +140,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
       case "execute_transaction": {
         const { connection, queries } = args || {};
-        if (!connection) return fail("'connection' alani zorunludur.");
+        if (!connection) return fail("'connection' field is required.");
         if (!Array.isArray(queries) || queries.length === 0) {
-          return fail("'queries' en az bir sorgu iceren bir dizi olmalidir.");
+          return fail("'queries' must be an array with at least one query.");
         }
 
         for (const q of queries) {
@@ -156,19 +156,19 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       case "suggest_query": {
         const { connection, query, reason } = args || {};
         return ok({
-          message: "MANUEL CALISTIRMA GEREKLI",
+          message: "MANUAL EXECUTION REQUIRED",
           connection,
-          reason: reason || "Yazma islemi",
+          reason: reason || "Write operation",
           query,
         });
       }
 
       default:
-        return fail(`Bilinmeyen arac: ${name}`);
+        return fail(`Unknown tool: ${name}`);
     }
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
-    return fail(`Hata: ${message}`);
+    return fail(`Error: ${message}`);
   }
 });
 
@@ -179,7 +179,7 @@ async function main() {
 
 main().catch((error) => {
   const message = error instanceof Error ? error.message : String(error);
-  console.error(`Sunucu baslatilamadi: ${message}`);
+  console.error(`Server failed to start: ${message}`);
   process.exit(1);
 });
 

package/src/sqlGuard.js

@@ -28,17 +28,17 @@ export function isWriteQuery(sql) {
 
 export function validateReadQuery(rawQuery) {
   if (typeof rawQuery !== "string") {
-    throw new Error("Sorgu metin (string) olmalidir.");
+    throw new Error("Query must be a string.");
   }
 
   const query = rawQuery.trim();
   if (!query) {
-    throw new Error("Sorgu bos olamaz.");
+    throw new Error("Query must not be empty.");
   }
 
   if (!isReadQuery(query)) {
     throw new Error(
-      "Yalnizca SELECT/SHOW/DESCRIBE/EXPLAIN sorgularina izin verilir."
+      "Only SELECT/SHOW/DESCRIBE/EXPLAIN queries are allowed."
     );
   }
 
@@ -47,23 +47,23 @@ export function validateReadQuery(rawQuery) {
 
 export function validateWriteQuery(rawQuery) {
   if (typeof rawQuery !== "string") {
-    throw new Error("Sorgu metin (string) olmalidir.");
+    throw new Error("Query must be a string.");
   }
 
   const query = rawQuery.trim();
   if (!query) {
-    throw new Error("Sorgu bos olamaz.");
+    throw new Error("Query must not be empty.");
   }
 
   if (isReadQuery(query)) {
     throw new Error(
-      "Read-only sorgular (SELECT/SHOW/DESCRIBE/EXPLAIN) execute_write'da kullanilamaz. execute_select kullanin."
+      "Read-only queries (SELECT/SHOW/DESCRIBE/EXPLAIN) cannot be used with execute_write. Use execute_select instead."
     );
   }
 
   if (!isWriteQuery(query)) {
     throw new Error(
-      `Sorgu gecerli bir yazma islemi olarak taninamadi. Izin verilen: ${WRITE_PREFIXES.join(", ")}`
+      `Query was not recognized as a valid write operation. Allowed prefixes: ${WRITE_PREFIXES.join(", ")}`
     );
   }
 
@@ -74,9 +74,9 @@ export function validateWriteQuery(rawQuery) {
  * Resolves the effective row limit for a query.
  * Returns null when no limit should be applied.
  *
- * - Config'de default_row_limit / max_row_limit yoksa (0) → sinirsiz
- * - Kullanici row_limit verdiyse ve max_row_limit varsa → min(request, max) uygulanir
- * - Kullanici row_limit vermediyse ama default_row_limit varsa → default uygulanir
+ * - If default_row_limit / max_row_limit are absent (0) → unlimited
+ * - If the caller provides row_limit and max_row_limit is set → min(requested, max) is used
+ * - If the caller omits row_limit but default_row_limit is set → default is used
  */
 export function resolveRowLimit(requestedRowLimit, connectionConfig) {
   const defaultLimit = connectionConfig.default_row_limit || 0;
@@ -85,7 +85,7 @@ export function resolveRowLimit(requestedRowLimit, connectionConfig) {
   if (requestedRowLimit != null) {
     const n = Number(requestedRowLimit);
     if (!Number.isFinite(n) || n <= 0) {
-      throw new Error("row_limit pozitif bir sayi olmalidir.");
+      throw new Error("row_limit must be a positive number.");
     }
     const chosen = Math.floor(n);
     return maxLimit > 0 ? Math.min(chosen, maxLimit) : chosen;

package/src/tools.js

@@ -6,12 +6,12 @@ export function buildToolDefinitions(
   const tools = [
     {
       name: "list_connections",
-      description: "Tanimli MariaDB baglantilarini listeler.",
+      description: "Lists configured MariaDB connections.",
       inputSchema: { type: "object", properties: {} },
     },
     {
       name: "list_databases",
-      description: "Secilen baglantidaki veritabanlarini listeler.",
+      description: "Lists databases for the selected connection.",
       inputSchema: {
         type: "object",
         properties: {
@@ -22,7 +22,7 @@ export function buildToolDefinitions(
     },
     {
       name: "list_tables",
-      description: "Secilen baglantida tablolari listeler.",
+      description: "Lists tables for the selected connection.",
       inputSchema: {
         type: "object",
         properties: {
@@ -34,7 +34,7 @@ export function buildToolDefinitions(
     },
     {
       name: "describe_table",
-      description: "Bir tablonun kolon bilgilerini dondurur.",
+      description: "Returns column information for a table.",
       inputSchema: {
         type: "object",
         properties: {
@@ -48,7 +48,7 @@ export function buildToolDefinitions(
     {
       name: "execute_select",
       description:
-        "Salt-okunur SELECT/SHOW/DESCRIBE/EXPLAIN sorgusu calistirir. Satir limiti uygulanir.",
+        "Executes a read-only SELECT/SHOW/DESCRIBE/EXPLAIN query. Row limit is enforced.",
       inputSchema: {
         type: "object",
         properties: {
@@ -66,7 +66,7 @@ export function buildToolDefinitions(
     tools.push(
       {
         name: "execute_write",
-        description: `INSERT/UPDATE/DELETE/CREATE/ALTER/DROP vb. yazma sorgusu calistirir. Baglantilar: ${writableConnections.join(", ")}`,
+        description: `Executes a write query (INSERT/UPDATE/DELETE/CREATE/ALTER/DROP etc.). Connections: ${writableConnections.join(", ")}`,
         inputSchema: {
           type: "object",
           properties: {
@@ -78,7 +78,7 @@ export function buildToolDefinitions(
       },
       {
         name: "execute_transaction",
-        description: `Birden fazla yazma sorgusunu transaction icinde calistirir. Baglantilar: ${writableConnections.join(", ")}`,
+        description: `Executes multiple write queries within a transaction. Connections: ${writableConnections.join(", ")}`,
         inputSchema: {
           type: "object",
           properties: {
@@ -97,7 +97,7 @@ export function buildToolDefinitions(
 
   tools.push({
     name: "suggest_query",
-    description: "Manuel calistirilmasi gereken bir sorgu onerir.",
+    description: "Suggests a query that should be executed manually.",
     inputSchema: {
       type: "object",
       properties: {