mcp_server_mariadb_reader

mcp_server_mariadb_reader

3.2

If you are the rightful owner of mcp_server_mariadb_reader and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

MariaDB Reader MCP Server is designed to facilitate exploration and interaction with MariaDB databases through the Model Context Protocol (MCP). It provides tools for AI assistants like Cline to access and query MariaDB databases.

MariaDB Reader MCP Server

이 ν”„λ‘œμ νŠΈλŠ” MariaDB λ°μ΄ν„°λ² μ΄μŠ€λ₯Ό νƒμƒ‰ν•˜κ³  μƒν˜Έμž‘μš©ν•˜κΈ° μœ„ν•œ Model Context Protocol (MCP) μ„œλ²„μž…λ‹ˆλ‹€. 이 μ„œλ²„λŠ” Clineκ³Ό 같은 AI μ–΄μ‹œμŠ€ν„΄νŠΈκ°€ MariaDB λ°μ΄ν„°λ² μ΄μŠ€μ— μ ‘κ·Όν•˜μ—¬ 정보λ₯Ό μ‘°νšŒν•  수 μžˆλ„λ‘ 도ꡬλ₯Ό μ œκ³΅ν•©λ‹ˆλ‹€.

κΈ°λŠ₯

이 MCP μ„œλ²„λŠ” λ‹€μŒκ³Ό 같은 도ꡬλ₯Ό μ œκ³΅ν•©λ‹ˆλ‹€:

  • list_databases: μ ‘κ·Ό κ°€λŠ₯ν•œ λͺ¨λ“  λ°μ΄ν„°λ² μ΄μŠ€μ˜ λͺ©λ‘μ„ λ°˜ν™˜ν•©λ‹ˆλ‹€.
  • list_tables: μ§€μ •λœ λ°μ΄ν„°λ² μ΄μŠ€ λ‚΄μ˜ λͺ¨λ“  ν…Œμ΄λΈ” λͺ©λ‘μ„ λ°˜ν™˜ν•©λ‹ˆλ‹€.
    • μž…λ ₯: database (λ¬Έμžμ—΄, ν•„μˆ˜) - ν…Œμ΄λΈ” λͺ©λ‘μ„ μ‘°νšŒν•  λ°μ΄ν„°λ² μ΄μŠ€ 이름.
  • get_table_schema: μ§€μ •λœ ν…Œμ΄λΈ”μ˜ μŠ€ν‚€λ§ˆ(컬럼 μ •μ˜)λ₯Ό λ°˜ν™˜ν•©λ‹ˆλ‹€.
    • μž…λ ₯:
      • database (λ¬Έμžμ—΄, ν•„μˆ˜) - ν…Œμ΄λΈ”μ΄ μ†ν•œ λ°μ΄ν„°λ² μ΄μŠ€ 이름.
      • table (λ¬Έμžμ—΄, ν•„μˆ˜) - μŠ€ν‚€λ§ˆλ₯Ό μ‘°νšŒν•  ν…Œμ΄λΈ” 이름.
  • query_table: μ§€μ •λœ ν…Œμ΄λΈ”μ—μ„œ 데이터λ₯Ό μ‘°νšŒν•©λ‹ˆλ‹€. 기본적으둜 처음 100개의 행을 λ°˜ν™˜ν•©λ‹ˆλ‹€.
    • μž…λ ₯:
      • database (λ¬Έμžμ—΄, ν•„μˆ˜) - ν…Œμ΄λΈ”μ΄ μ†ν•œ λ°μ΄ν„°λ² μ΄μŠ€ 이름.
      • table (λ¬Έμžμ—΄, ν•„μˆ˜) - 데이터λ₯Ό μ‘°νšŒν•  ν…Œμ΄λΈ” 이름.
      • limit (숫자, 선택) - λ°˜ν™˜ν•  μ΅œλŒ€ ν–‰ 수 (κΈ°λ³Έκ°’: 100).

μ„€μ •

이 μ„œλ²„λ₯Ό μ‚¬μš©ν•˜λ €λ©΄ GitHub μ €μž₯μ†Œλ₯Ό ν΄λ‘ ν•˜κ³ , MCP ν΄λΌμ΄μ–ΈνŠΈ(예: VS Code ν™•μž₯ ν”„λ‘œκ·Έλž¨)의 μ„€μ • νŒŒμΌμ— μ„œλ²„ 정보λ₯Ό 등둝해야 ν•©λ‹ˆλ‹€. 이 μ €μž₯μ†Œμ—λŠ” 미리 λΉŒλ“œλœ μ‹€ν–‰ 파일(build/index.js)이 ν¬ν•¨λ˜μ–΄ μžˆμ–΄ λ³„λ„μ˜ λΉŒλ“œ 과정이 ν•„μš”ν•˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€.

  1. μ €μž₯μ†Œ 클둠: μ›ν•˜λŠ” μœ„μΉ˜μ— 이 μ €μž₯μ†Œλ₯Ό ν΄λ‘ ν•©λ‹ˆλ‹€.
    git clone https://github.com/moosin76/mcp_server_mariadb_reader.git
    
  2. MCP μ„€μ • 파일 μˆ˜μ •:

μ„€μ • μ˜ˆμ‹œ:

{
  "mcpServers": {
    "mcp_server_mariadb_reader": {
      "command": "node",
      "args": ["<클둠된 μ €μž₯μ†Œ 경둜>/build/index.js"], // 클둠된 μ €μž₯μ†Œ λ‚΄ build/index.js 파일 경둜
      "env": {
        "MARIADB_HOST": "YOUR_DB_HOST",         // MariaDB 호슀트 μ£Όμ†Œ
        "MARIADB_PORT": "YOUR_DB_PORT",         // MariaDB 포트 번호 (예: "3306")
        "MARIADB_USER": "YOUR_DB_USER",         // MariaDB μ‚¬μš©μž 이름
        "MARIADB_PASSWORD": "YOUR_DB_PASSWORD", // MariaDB λΉ„λ°€λ²ˆν˜Έ
        "MARIADB_DATABASE": "YOUR_DEFAULT_DB"   // (선택) κΈ°λ³Έ λ°μ΄ν„°λ² μ΄μŠ€ 이름
      },
      "disabled": false,
      "autoApprove": []
    }
    // λ‹€λ₯Έ MCP μ„œλ²„ μ„€μ •...
  }
}

주의:

  • <클둠된 μ €μž₯μ†Œ 경둜> 뢀뢄을 μ‹€μ œ μ €μž₯μ†Œλ₯Ό ν΄λ‘ ν•œ 둜컬 경둜둜 λ³€κ²½ν•΄μ•Ό ν•©λ‹ˆλ‹€. (예: C:/Users/YourUser/Documents/GitHub/mcp_server_mariadb_reader)
  • env 객체 λ‚΄μ˜ MariaDB μ—°κ²° 정보λ₯Ό μ‹€μ œ ν™˜κ²½μ— 맞게 μˆ˜μ •ν•΄μ•Ό ν•©λ‹ˆλ‹€.

개발 (μ†ŒμŠ€ μ½”λ“œ μˆ˜μ • μ‹œ)

이 μ €μž₯μ†Œμ—λŠ” λΉŒλ“œλœ 파일이 ν¬ν•¨λ˜μ–΄ μžˆμœΌλ―€λ‘œ, μ„œλ²„λ₯Ό μ‚¬μš©ν•˜κΈ° μœ„ν•΄ μ•„λž˜ 단계λ₯Ό μˆ˜ν–‰ν•  ν•„μš”λŠ” μ—†μŠ΅λ‹ˆλ‹€. μ†ŒμŠ€ μ½”λ“œ(src 디렉토리)λ₯Ό 직접 μˆ˜μ •ν•˜κ³  λ³€κ²½ 사항을 μ μš©ν•˜λ €λ©΄ λ‹€μŒ 단계λ₯Ό λ”°λ₯΄μ„Έμš”.

  1. μ˜μ‘΄μ„± μ„€μΉ˜ (졜초 ν•œ 번 λ˜λŠ” package.json λ³€κ²½ μ‹œ):
    npm install
    
  2. μˆ˜μ • ν›„ λΉŒλ“œ:
    npm run build
    
    • 이 λͺ…령은 src λ””λ ‰ν† λ¦¬μ˜ TypeScript μ½”λ“œλ₯Ό build λ””λ ‰ν† λ¦¬μ˜ JavaScript μ½”λ“œλ‘œ μ»΄νŒŒμΌν•©λ‹ˆλ‹€.
  3. (선택) 개발 쀑 λ³€κ²½ 사항 감지 및 μžλ™ λΉŒλ“œ:
    npm run watch
    

λΌμ΄μ„ μŠ€

이 ν”„λ‘œμ νŠΈλŠ” [λΌμ΄μ„ μŠ€ 정보 μž…λ ₯] λΌμ΄μ„ μŠ€ ν•˜μ— λ°°ν¬λ©λ‹ˆλ‹€.