mcp_server_mariadb_reader
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
)μ΄ ν¬ν¨λμ΄ μμ΄ λ³λμ λΉλ κ³Όμ μ΄ νμνμ§ μμ΅λλ€.
- μ μ₯μ ν΄λ‘ : μνλ μμΉμ μ΄ μ μ₯μλ₯Ό ν΄λ‘ ν©λλ€.
git clone https://github.com/moosin76/mcp_server_mariadb_reader.git
- 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
λλ ν 리)λ₯Ό μ§μ μμ νκ³ λ³κ²½ μ¬νμ μ μ©νλ €λ©΄ λ€μ λ¨κ³λ₯Ό λ°λ₯΄μΈμ.
- μμ‘΄μ± μ€μΉ (μ΅μ΄ ν λ² λλ
package.json
λ³κ²½ μ):npm install
- μμ ν λΉλ:
npm run build
- μ΄ λͺ
λ Ήμ
src
λλ ν 리μ TypeScript μ½λλ₯Όbuild
λλ ν 리μ JavaScript μ½λλ‘ μ»΄νμΌν©λλ€.
- μ΄ λͺ
λ Ήμ
- (μ ν) κ°λ° μ€ λ³κ²½ μ¬ν κ°μ§ λ° μλ λΉλ:
npm run watch
λΌμ΄μ μ€
μ΄ νλ‘μ νΈλ [λΌμ΄μ μ€ μ 보 μ λ ₯] λΌμ΄μ μ€ νμ λ°°ν¬λ©λλ€.