@ninebone/mcp 0.1.26

package/README.kr.md

@@ -0,0 +1,71 @@
+cat <<EOF > README.kr.md
+# @nine-lab/nine-mcp 🚀
+
+[한국어 문서(Korean)](./README.kr.md) | [English Document](./README.md)
+
+자연어 기반 SQL 생성 엔진(NineChat)과 데이터베이스 사이를 연결하는 **AI 전용 DB 커넥터 서비스**입니다.
+
+데이터베이스의 구조(Schema)를 분석하여 AI가 최적의 쿼리를 생성할 수 있도록 브릿지 역할을 수행하며, 보안이 검증된 환경에서 데이터를 안전하게 반환합니다.
+
+---
+
+## 🌟 주요 기능
+
+* **자동 초기화**: \`nine-mcp init\` 명령으로 \`.env\` 설정과 AI 프롬프트 템플릿을 즉시 구축합니다.
+* **Multi-DB 지원**: MySQL, PostgreSQL, MariaDB, Oracle 등 다양한 엔터프라이즈 DB 환경에 대응합니다.
+* **비즈니스 로직 최적화**: 프롬프트 파일 수정을 통해 특정 테이블 조회 금지, 필터링 조건 강제 등 고객사별 맞춤 규칙을 적용할 수 있습니다.
+* **보안 가드**: 내부적으로 오직 \`SELECT\` 쿼리만 허용하여 데이터 변조 및 유출을 원천 차단합니다.
+* **운영 안정성**: BigInt 직렬화 및 DB별 결과 포맷 정규화를 통해 데이터 일관성을 보장합니다.
+
+---
+
+## 🛠 설치 및 사용 방법
+
+### 1. 패키지 설치
+\`\`\`bash
+npm install -g @nine-lab/nine-mcp
+\`\`\`
+
+### 2. 프로젝트 초기화 (최초 1회)
+서버 실행 전 DB 접속 정보 및 프롬프트 환경 구성을 위해 실행합니다.
+\`\`\`bash
+nine-mcp init
+\`\`\`
+
+### 3. 서버 실행 및 관리 (PM2 권장)
+서버의 안정적인 기동과 로그 관리를 위해 프로세스 이름을 패키지명과 동일한 **nine-mcp**로 관리하는 것을 권장합니다.
+
+* **서버 시작**:
+  \`\`\`bash
+  pm2 start nine-mcp --name "nine-mcp"
+  \`\`\`
+* **상태 확인**:
+  \`\`\`bash
+  pm2 status
+  \`\`\`
+* **로그 확인**:
+  \`\`\`bash
+  pm2 logs nine-mcp
+  \`\`\`
+* **서버 중지/재시작**:
+  \`\`\`bash
+  pm2 stop nine-mcp
+  pm2 restart nine-mcp
+  \`\`\`
+
+---
+
+## 📂 프로젝트 구조 및 커스터마이징
+
+기본적으로 \`nine-query\` 컴포넌트와 연동되어 동작하며, 아래 파일들을 통해 세부 동작을 제어할 수 있습니다.
+
+* **.env**: DB 접속 정보 및 AI 모델(Gemini) 설정값
+* **prompts/table-filter.md**: 질문에 적합한 테이블을 찾아내는 AI의 판단 로직
+* **prompts/query-generator.md**: 실제 SQL을 생성하는 AI의 페르소나 및 규칙
+    * **💡 Tip**: 이 파일의 \`[고객사 전용 비즈니스 로직 및 보안 규칙]\` 섹션에 "특정 민감 테이블 조회 금지"나 "기본 정렬/필터링 기준"을 명시하여 AI의 답변을 통제할 수 있습니다.
+
+---
+
+## 📄 라이선스
+MIT © **nine-lab**
+EOF

package/README.md

@@ -0,0 +1,72 @@
+cat <<EOF > README.md
+# @nine-lab/nine-mcp 🚀
+
+[한국어 문서(Korean)](./README.kr.md) | [English Document](./README.md)
+
+**NineConnector** is an AI-specialized database connector service that bridges the gap between natural language SQL generation engines (**NineChat**) and your database.
+
+It analyzes database schemas to provide AI models with the necessary metadata for optimal query generation and ensures secure data retrieval within a verified environment.
+
+---
+
+## 🌟 Key Features
+
+* **Auto-Initialization**: Instantly set up your environment with \`.env\` configurations and AI prompt templates using the \`nine-mcp init\` command.
+* **Multi-DB Support**: Out-of-the-box compatibility with enterprise database environments including **MySQL, PostgreSQL, MariaDB, and Oracle**.
+* **Business Logic Optimization**: Fine-tune AI behavior by customizing prompt files to enforce rules such as table access restrictions or mandatory filtering logic.
+* **Security Guardrail**: Strictly restricts execution to \`SELECT\` queries to prevent unauthorized data modification or leakage.
+* **Operational Stability**: Ensures data consistency through **BigInt serialization** and standardized result formatting across different DB dialects.
+
+---
+
+## 🛠 Installation & Quick Start
+
+### 1. Install Package
+Install the package globally to access the CLI commands from anywhere.
+\`\`\`bash
+npm install -g @nine-lab/nine-mcp
+\`\`\`
+
+### 2. Initialize Project (First-time setup)
+Run the initialization command to configure DB connection settings and generate prompt templates.
+\`\`\`bash
+nine-mcp init
+\`\`\`
+
+### 3. Server Execution & Management (PM2 Recommended)
+For production environments, we highly recommend using **PM2** to ensure high availability and efficient log management.
+
+* **Start Server**:
+  \`\`\`bash
+  pm2 start nine-mcp --name "nine-mcp"
+  \`\`\`
+* **Check Status**:
+  \`\`\`bash
+  pm2 status
+  \`\`\`
+* **View Logs**:
+  \`\`\`bash
+  pm2 logs nine-mcp
+  \`\`\`
+* **Stop / Restart**:
+  \`\`\`bash
+  pm2 stop nine-mcp
+  pm2 restart nine-mcp
+  \`\`\`
+
+---
+
+## 📂 Project Structure & Customization
+
+Designed to work seamlessly with the \`nine-query\` component, you can control the AI's behavior via the following files:
+
+* **.env**: Database credentials and AI model (e.g., Gemini) configurations.
+* **prompts/table-filter.md**: AI logic for identifying relevant tables based on user intent.
+* **prompts/query-generator.md**: Persona and rules for the SQL generation AI.
+    * **💡 Tip**: Use the \`[Custom Business Logic & Security Rules]\` section in this file to enforce specific constraints, such as "Do not access sensitive user tables" or "Always apply a default sort order."
+
+---
+
+## 📄 License
+MIT © **nine-lab**
+EOF

package/bak/generate-query.md

@@ -0,0 +1,28 @@
+### SQL_GENERATE_PROMPT
+당신은 SQL 생성기입니다. 제공된 테이블 정보를 바탕으로 사용자의 질문에 답하는 최적의 SQL 쿼리를 작성하세요.
+
+[선택된 테이블 정보]
+{detailed_schema}
+
+[사용자 질문]
+"{question}"
+
+[데이터베이스 타입]
+{db_type}
+
+[기본 응답 규칙]
+1. 반드시 JSON 형식으로만 응답하세요.
+2. SQL은 {db_type} 문법에 완벽하게 맞아야 하며, 즉시 실행 가능해야 합니다.
+3. 쿼리문 안에 마크다운 코드 블록(```sql)을 포함하지 마세요.
+
+[고객사 전용 비즈니스 로직 및 보안 규칙]
+- 사용자가 특정 단어(예: 지명, 상호명, 기술명)를 언급하며 조회를 요청할 경우,
+  고정값 비교(=) 대신 반드시 'LIKE %검색어%' 패턴을 사용하세요.
+-
+(여기에 "특정 테이블 조회 금지"나 "기본 정렬 기준" 등 커스텀 규칙을 작성하세요.)
+
+[응답 포맷]
+{{
+"sql": "SELECT ... FROM ... WHERE ...",
+"explanation": "이 쿼리는 어떤 데이터를 어떻게 조회하는지에 대한 설명입니다."
+}}

package/bak/generator-source-mapper.md

@@ -0,0 +1,123 @@
+너는 Spring 기반 백엔드에서 MyBatis SQL Mapper XML을 작성하는 AI입니다.
+
+지금부터 사용자로부터 받은 **기능 설명**과 **테이블 스키마 정보**를 바탕으로, 아래 조건을 **모두 만족**하는 **MyBatis SQL Mapper XML 파일(.xml)**을 작성해주세요.
+
+---
+
+**[사용자 요청 기능 설명]**
+
+
+**[테이블 스키마 정보 (JSON)]**
+{schema_detail}
+
+---
+
+**[XML 작성 필수 조건]**
+
+1.  **XML 기본 구조:**
+    * `<?xml version="1.0" encoding="UTF-8"?>` 및 `<!DOCTYPE mapper ...>` 선언을 **반드시 포함**해야 합니다.
+    * 전체 XML 코드는 `<mapper namespace="{namespace}" >` 태그로 감싸야 합니다.
+    * `namespace` 값은 `{namespace}` 플레이스홀더에 전달된 값으로 정확하게 채워야 합니다.
+    * **인터페이스 파일은 가정하지 않으며, XML 단독으로 동작하도록 합니다.**
+
+2.  **필수 쿼리 구성:**
+    * **`selectList`**: 목록 조회 (필수: `ORDER BY` 절 포함)
+    * **`selectOne`**: 단일 건 조회 (주요 컬럼을 WHERE 조건에 포함)
+    * **`insert`**: 데이터 삽입
+    * **`update`**: 데이터 업데이트 (주요 컬럼을 WHERE 조건에 포함)
+    * **`delete`**: 데이터 삭제 (주요 컬럼을 WHERE 조건에 포함)
+
+3.  **SQL 작성 규칙:**
+    * SQL은 제공된 **테이블 스키마(컬럼명, 데이터 타입)**를 기반으로 작성되어야 합니다.
+    * **자주 사용될 것으로 예상되는 컬럼** (예: ID, 이름, 상태 등)은 `selectOne`, `update`, `delete` 쿼리의 `WHERE` 조건에 포함해야 합니다.
+    * `result_type`은 **반드시 `{result_type}`으로 처리**합니다.
+    * `selectList` 쿼리에는 동적 WHERE 조건 처리를 위해 **반드시 아래 구문을 주입**해야 합니다:
+        ```xml
+        <where>
+            <if test="_whereClause != null"> AND ${{_whereClause}} </if>
+        </where>
+        ```
+    * `selectList` 쿼리에는 **반드시 `ORDER BY` 절을 명시**하여 정렬 기준을 제공합니다.
+
+4.  **출력 형식:**
+    * 결과는 **오직 완성된 XML 코드만 텍스트로 출력**해야 합니다. (설명 텍스트나 주석 없이)
+    * **마크다운 코드 블록(```xml`)은 절대 사용하지 마세요.**
+
+---
+
+**[출력 예시]** (AI는 이 형식에 맞춰 XML 코드만 출력해야 합니다.)
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+<mapper namespace="com.example.mapper.BoardMapper">
+
+    <select id="selectList" resultType="`{result_type}`">
+        SELECT
+            BOARD_ID,
+            TITLE,
+            CONTENT,
+            REG_DATE
+        FROM
+            TB_BOARD
+        <where>
+            <if test="_whereClause != null"> AND ${{_whereClause}} </if>
+        </where>
+        <where>
+            <if test="borderId != null"> BOARD_ID = ${{borderId}} </if>
+        </where>
+        <where>
+            <if test="title != null"> TITLE = ${{title}} </if>
+        </where>
+        <where>
+            <if test="content != null"> CONTENT = ${{content}} </if>
+        </where>
+        <where>
+            <if test="regDate != null"> REG_DATE = ${{regDate}} </if>
+        </where>
+        ORDER BY
+            BOARD_ID DESC
+    </select>
+
+    <select id="selectOne" resultType="java.util.Map">
+        SELECT
+            BOARD_ID,
+            TITLE,
+            CONTENT,
+            REG_DATE
+        FROM
+            TB_BOARD
+        WHERE
+            BOARD_ID = #{{boardId}}
+    </select>
+
+    <insert id="insert" parameterType="java.util.Map">
+        INSERT INTO TB_BOARD (
+            BOARD_ID,
+            TITLE,
+            CONTENT,
+            REG_DATE
+        ) VALUES (
+            #{{boardId}},
+            #{{title}},
+            #{{content}},
+            NOW()
+        )
+    </insert>
+
+    <update id="update" parameterType="java.util.Map">
+        UPDATE TB_BOARD
+        SET
+            TITLE = #{{title}},
+            CONTENT = #{{content}}
+        WHERE
+            BOARD_ID = #{{boardId}}
+    </update>
+
+    <delete id="delete" parameterType="java.util.Map">
+        DELETE FROM TB_BOARD
+        WHERE
+            BOARD_ID = #{{boardId}}
+    </delete>
+
+</mapper>