@cano721/mysql-mcp-server 0.7.0 → 0.8.1

package/README.md

@@ -343,6 +343,11 @@ MySQL 서버에서 접근 가능한 모든 데이터베이스를 나열합니다
 - `table` (필수): 연관 테이블을 찾을 기준 테이블명
 - `database` (선택사항): 데이터베이스명
 - `depth` (선택사항): 탐색할 최대 깊이 (기본값: 3, 10 초과 시 경고)
+- `include_pattern_match` (선택사항): 컬럼명 패턴 매칭 포함 여부 (기본값: false)
+
+**검색 방법**:
+1. **FK 제약조건 기반** (기본): 실제 Foreign Key가 설정된 테이블만 조회
+2. **패턴 매칭 포함**: `user_sn`, `user_id` 같은 컬럼명 패턴으로 추가 테이블 탐색
 
 **예제**:
 ```json
@@ -357,29 +362,41 @@ MySQL 서버에서 접근 가능한 모든 데이터베이스를 나열합니다
 }
 ```
 
+**패턴 매칭 포함 예제**:
+```json
+{
+  "server_name": "mysql",
+  "tool_name": "get_related_tables",
+  "arguments": {
+    "database": "my_database",
+    "table": "user",
+    "depth": 2,
+    "include_pattern_match": true
+  }
+}
+```
+
 **응답 예시**:
 ```json
 {
   "root_table": "user",
   "database": "my_database",
   "requested_depth": 2,
+  "search_method": "fk_constraint",
+  "fk_relations_count": 55,
+  "pattern_match_count": 0,
   "total_relations": 55,
-  "relations": [
+  "fk_relations": [
     {
       "depth": 1,
       "child_table": "user_matching_information",
       "fk_column": "user_sn",
       "parent_table": "user",
-      "constraint_name": "FK_USER_MATCHING_INFORMATION_USER_SN"
-    },
-    {
-      "depth": 2,
-      "child_table": "user_matching_profile",
-      "fk_column": "user_matching_information_sn",
-      "parent_table": "user_matching_information",
-      "constraint_name": "FK_USER_MATCHING_PROFILE_USER_INFORMATION_SN"
+      "constraint_name": "FK_USER_MATCHING_INFORMATION_USER_SN",
+      "match_type": "fk_constraint"
     }
-  ]
+  ],
+  "note": "FK 제약조건 기반으로 조회되었습니다. 패턴 매칭도 포함하려면 '패턴 매칭도 포함해줘'라고 요청해보세요."
 }
 ```
 
@@ -775,6 +792,7 @@ echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | npx @cano721/mysql-mcp-s
 
 | 버전 | 날짜 | 주요 변경 사항 |
 |------|------|---------------|
+| 0.8.0 | 2025-01-09 | `get_related_tables`에 패턴 매칭 옵션 추가, depth 제한 제거 |
 | 0.7.0 | 2025-01-09 | `get_related_tables` 도구 추가 (FK 기반 연관 테이블 depth별 조회) |
 | 0.6.0 | 2025-01-09 | `analyze_table` → `analyze_query`로 변경, `@latest` 태그 문서 추가 |
 | 0.5.0 | 2025-01-09 | `explain_query`, `analyze_table` 전용 도구 추가 |

package/build/index.js

@@ -122,7 +122,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
         },
         {
             name: "get_related_tables",
-            description: "Get all tables related to a specific table through foreign keys (parent and child relationships with depth)",
+            description: "Find all related/connected/associated tables linked to a specific table through foreign keys. Discovers table relationships and dependencies with depth traversal. Use this when asked to find related tables, connected tables, associated tables, or table relationships.",
             inputSchema: {
                 type: "object",
                 properties: {
@@ -137,6 +137,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                     depth: {
                         type: "number",
                         description: "Maximum depth to traverse relationships (default: 3, warning if > 10)"
+                    },
+                    include_pattern_match: {
+                        type: "boolean",
+                        description: "Include tables found by column name pattern matching (e.g., user_sn, user_id). Default: false"
                     }
                 },
                 required: ["table"]
@@ -295,6 +299,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 const table = request.params.arguments?.table;
                 const database = request.params.arguments?.database;
                 const requestedDepth = request.params.arguments?.depth || 3;
+                const includePatternMatch = request.params.arguments?.include_pattern_match || false;
                 if (!table) {
                     throw new McpError(ErrorCode.InvalidParams, "Table name is required");
                 }
@@ -340,7 +345,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                             child_table: row.child_table,
                             fk_column: row.fk_column,
                             parent_table: row.parent_table,
-                            constraint_name: row.constraint_name
+                            constraint_name: row.constraint_name,
+                            match_type: 'fk_constraint'
                         });
                         if (!visited.has(row.child_table)) {
                             visited.add(row.child_table);
@@ -371,7 +377,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                                 child_table: row.child_table,
                                 fk_column: row.fk_column,
                                 parent_table: row.parent_table,
-                                constraint_name: row.constraint_name
+                                constraint_name: row.constraint_name,
+                                match_type: 'fk_constraint'
                             });
                         }
                         if (!visited.has(row.parent_table)) {
@@ -386,12 +393,55 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                         return a.depth - b.depth;
                     return a.child_table.localeCompare(b.child_table);
                 });
+                // Pattern matching for tables without FK constraints
+                let patternMatchResults = [];
+                if (includePatternMatch) {
+                    console.error('[Tool] Including pattern match results');
+                    // Common patterns: table_sn, table_id, table_code, sn_table, id_table
+                    const patterns = [
+                        `${table}_sn`, `${table}_id`, `${table}_code`,
+                        `sn_${table}`, `id_${table}`,
+                        `${table}sn`, `${table}id`
+                    ];
+                    const patternQuery = `
+            SELECT DISTINCT
+              c.TABLE_NAME as related_table,
+              c.COLUMN_NAME as matching_column
+            FROM information_schema.COLUMNS c
+            WHERE c.TABLE_SCHEMA = ?
+              AND c.TABLE_NAME != ?
+              AND (${patterns.map(() => 'LOWER(c.COLUMN_NAME) = LOWER(?)').join(' OR ')})
+          `;
+                    const { rows: patternRows } = await executeQuery(pool, patternQuery, [dbName, table, ...patterns]);
+                    // Filter out tables already found via FK
+                    const fkTables = new Set(results.map(r => r.child_table));
+                    fkTables.add(table);
+                    for (const row of patternRows) {
+                        if (!fkTables.has(row.related_table)) {
+                            patternMatchResults.push({
+                                depth: 1,
+                                child_table: row.related_table,
+                                fk_column: row.matching_column,
+                                parent_table: table,
+                                constraint_name: '(pattern match)',
+                                match_type: 'pattern_match'
+                            });
+                        }
+                    }
+                }
                 const response = {
                     root_table: table,
                     database: dbName,
                     requested_depth: requestedDepth,
-                    total_relations: results.length,
-                    relations: results
+                    search_method: includePatternMatch ? 'fk_constraint + pattern_match' : 'fk_constraint',
+                    fk_relations_count: results.length,
+                    pattern_match_count: patternMatchResults.length,
+                    total_relations: results.length + patternMatchResults.length,
+                    fk_relations: results,
+                    pattern_match_relations: includePatternMatch ? patternMatchResults : undefined,
+                    note: includePatternMatch
+                        ? "FK 제약조건 + 컬럼명 패턴 매칭 결과입니다."
+                        : "FK 제약조건 기반으로 조회되었습니다. 패턴 매칭도 포함하려면 '패턴 매칭도 포함해줘'라고 요청해보세요."
                 };
                 if (warning) {
                     response.warning = warning;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cano721/mysql-mcp-server",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "An MCP server that provides read-only access to MySQL databases.",
   "type": "module",
   "bin": {