mcp-db-server
ๅบไบ Spring AI MCP Server ็้็จๆฐๆฎๅบ MCP ๆๅกใๅฎๅ จๆ ็ถๆโโๆฐๆฎๅบ่ฟๆฅไฟกๆฏ็ฑ AI ๅฎขๆท็ซฏๅจๆฏๆฌก่ฐ็จๆถไผ ๅ ฅ๏ผๆๅก็ซฏไธๅญๅจไปปไฝ่ฟๆฅ้ ็ฝฎๆๆฐๆฎใ
ๆฏๆ MySQLใPostgreSQLใH2ใSQLiteใSQL ServerใOracle ๅ ญๅคงๆฐๆฎๅบใ
็ฎๅฝ
- ็นๆง
- ่ฎพ่ฎก็ๅฟต
- ๆฏๆ็ๆฐๆฎๅบ
- ๅฟซ้ๅผๅง
- MCP ๅทฅๅ ทๆฅๅฃ
- ้ๆๅฐ AI ๅฎขๆท็ซฏ
- ้กน็ฎ็ปๆ
- ๅผๅๆๅ
- License
็นๆง
- ๐ MCP ๅ่ฎฎ๏ผๅบไบ Spring AI MCP Server๏ผSSE ไผ ่พๅ่ฎฎ๏ผๆ ็ผๅฏนๆฅ Claude DesktopใCursor ็ญ AI ๅฎขๆท็ซฏ
- ๐๏ธ ๅคๆฐๆฎๅบๆฏๆ๏ผMySQLใPostgreSQLใH2ใSQLiteใSQL ServerใOracle
- ๐ ๅฎๅ จๆ ็ถๆ๏ผไธๅญๅจไปปไฝ่ฟๆฅ้ ็ฝฎๆๆฐๆฎ๏ผ่ฟๆฅไฟกๆฏ็ฑๅฎขๆท็ซฏๅจๆฏๆฌก่ฐ็จๆถไผ ๅ ฅ
- ๐ HikariCP ่ฟๆฅๆฑ ๏ผ็ธๅ่ฟๆฅๅๆฐ่ชๅจๅค็จ็ญๆ็ผๅญ๏ผ5ๅ้ TTL๏ผ๏ผๅ ผ้กพๆง่ฝไธๅฎๅ จ
- ๐ณ Docker ้จ็ฝฒ๏ผๆไพ Dockerfile ๅ docker-compose.yml
- ๐ ๏ธ 6 ไธช MCP ๅทฅๅ ท๏ผ่กจๆฅ่ฏขใ่กจ็ปๆใ็ดขๅผใSQL ๆฅ่ฏขใSQL ๅๆไฝใๆฐๆฎๅบๅ ไฟกๆฏ
่ฎพ่ฎก็ๅฟต
โโโโโโโโโโโโโโโโ ่ฟๆฅๅๆฐ(ๆฏ่ฐ) โโโโโโโโโโโโโโโโโโโโ JDBC โโโโโโโโโโโโโโ
โ AI ๅฎขๆท็ซฏ โ โโโโโโโโโโโโโโโโโโโถ โ mcp-db-server โ โโโโโโโโโโโโถ โ ๆฐๆฎๅบ โ
โ (Claude็ญ) โ โโโโโโโโโโโโโโโโโโโ โ (ๆ ็ถๆๆๅก) โ โโโโโโโโโโโโ โ (MySQL็ญ) โ
โโโโโโโโโโโโโโโโ ๆฅ่ฏข็ปๆ โโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโ
- ๆๅก็ซฏไธๆไน ๅไปปไฝๆฐๆฎๅบ่ฟๆฅไฟกๆฏ
- AI ๅฎขๆท็ซฏๆฏๆฌก่ฐ็จๅทฅๅ
ทๆถ๏ผๅฐ
typeใhostใportใdatabaseใusernameใpasswordไฝไธบๅๆฐไผ ๅ ฅ - ๆๅก็ซฏๅจๅ ๅญไธญ็ญๆ็ผๅญ่ฟๆฅๆฑ ๏ผ5 ๅ้ TTL๏ผ๏ผ็ธๅๅๆฐ่ชๅจๅค็จ๏ผ่ฟๆ่ชๅจ้ๆพ
- ๆ้็ฑๆฐๆฎๅบ็จๆท่ช่บซ็ GRANT ๅณๅฎ๏ผๆๅก็ซฏไธๅ้ขๅคๆฆๆช
ๆฏๆ็ๆฐๆฎๅบ
ๅฟซ้ๅผๅง
็ฏๅข่ฆๆฑ
- JDK 17+ ๏ผๆจ่ JDK 21๏ผ
- Maven 3.6+ ๏ผๆไฝฟ็จ้กน็ฎๅ ็ฝฎ็ Maven Wrapper๏ผ
- Docker ๏ผๅฏ้๏ผ
Maven ๆฌๅฐ่ฟ่ก
# Windows (PowerShell)
.\mvnw.cmd spring-boot:run
# Linux / macOS
./mvnw spring-boot:run
ๆๅกๅฏๅจๅ๏ผMCP SSE ็ซฏ็นไธบ http://localhost:8088/sseใ
Docker ้จ็ฝฒ
# ๆๅปบ้ๅ
docker build -t mcp-db-server .
# ่ฟ่กๅฎนๅจ
docker run -d -p 8088:8088 --name mcp-db-server mcp-db-server
JAR ๅ ้จ็ฝฒ
./mvnw clean package -DskipTests
java -jar target/mcp-db-server-1.0.0.jar
MCP ๅทฅๅ ทๆฅๅฃ
ๆฏไธชๅทฅๅ ท้ฝ้่ฆ AI ๅฎขๆท็ซฏไผ ๅ ฅๅฎๆด็ๆฐๆฎๅบ่ฟๆฅๅๆฐใ
ๅ ฌๅ ฑ่ฟๆฅๅๆฐ๏ผๆฏไธชๅทฅๅ ทๆนๆณ้ฝๅ ๅซ๏ผ
ๅทฅๅ ทๅ่กจ
็คบไพ๏ผAI ่ฐ็จ listTables
ๅฝ AI ๅฎขๆท็ซฏ้่ฆๅๅบๆฌๅฐ MySQL ๆฐๆฎๅบ็่กจๆถ๏ผๅฎไผ่ฐ็จ๏ผ
Tool: listTables
type = "mysql"
host = "localhost"
port = 3306
database = "mydb"
username = "root"
password = "****"
้ๆๅฐ AI ๅฎขๆท็ซฏ
Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"mcp-db-server": {
"type": "sse",
"url": "http://localhost:8088/sse"
}
}
}
Cursor
{
"mcpServers": {
"mcp-db-server": {
"transport": "sse",
"url": "http://localhost:8088/sse"
}
}
}
Trae
ๅจ Trae ็ MCP ่ฎพ็ฝฎไธญๆทปๅ ๏ผ
{
"mcpServers": {
"mcp-db-server": {
"transport": "sse",
"url": "http://localhost:8088/sse"
}
}
}
ๆณจๆ๏ผไธๅๅฎขๆท็ซฏไฝฟ็จ็ SSE ็ซฏ็น่ทฏๅพๅฏ่ฝไธๅใๆฌ้กน็ฎ้ ็ฝฎ็ SSE ็ซฏ็นไธบ
/sse๏ผๆๆๅฎขๆท็ซฏ็ปไธไฝฟ็จhttp://localhost:8088/sse่ฟๆฅใ
้กน็ฎ็ปๆ
mcp-db-server/
โโโ src/main/java/com/mcp/db/
โ โโโ McpDbServerApplication.java # ๅฏๅจ็ฑป
โ โโโ config/
โ โ โโโ ConnectionFactory.java # ๅจๆ่ฟๆฅๅทฅๅ๏ผๅซ่ฟๆฅๆฑ ็ผๅญ๏ผ
โ โโโ tool/
โ โโโ DatabaseTools.java # MCP ๅทฅๅ
ทๆนๆณ๏ผ@Tool ๆณจ่งฃ๏ผ
โโโ src/main/resources/
โ โโโ application.yml # ๅบ็จ้
็ฝฎ๏ผไป
ๆๅก็ซฏๅฃๅ MCP ่ฎพ็ฝฎ๏ผ
โโโ sql/init/
โ โโโ 01-init-demo.sql # MySQL ็คบไพๅๅงๅๆฐๆฎ
โโโ Dockerfile # Docker ้ๅๆๅปบ
โโโ docker-compose.yml # ไธ้ฎ้จ็ฝฒ๏ผๅซ MySQL ็คบไพ๏ผ
โโโ .env.example # ็ฏๅขๅ้ๆจกๆฟ
โโโ pom.xml # Maven ไพ่ต็ฎก็
โโโ LICENSE
ๅผๅๆๅ
IDE ้ ็ฝฎ
ๆจ่ไฝฟ็จ IntelliJ IDEAใ
ๆๅปบ
# ็ผ่ฏ
./mvnw compile
# ่ฟ่กๆต่ฏ
./mvnw test
# ๆๅ
./mvnw clean package -DskipTests
ๆทปๅ ๆฐๆฐๆฎๅบๆฏๆ
- ๅจ
ConnectionFactory.javaไธญ๏ผDEFAULT_PORTSๆทปๅ ้ป่ฎค็ซฏๅฃๆ ๅฐDRIVER_CLASSESๆทปๅ JDBC ้ฉฑๅจ็ฑปๆ ๅฐbuildJdbcUrl()ๆทปๅ JDBC URL ๆๅปบ้ป่พ
- ๅจ
pom.xmlไธญๆทปๅ ๅฏนๅบ็ JDBC ้ฉฑๅจไพ่ต - ๆดๆฐๆฌๆๆกฃไธญ"ๆฏๆ็ๆฐๆฎๅบ"่กจๆ ผ
ๆฌข่ฟๆไบค PR๏ผ
่ดก็ฎ
่ฏทๅ้ CONTRIBUTING.md ไบ่งฃๅฆไฝๅไธ่ดก็ฎใ
License
ๆฌ้กน็ฎๅบไบ MIT License ๅผๆบใ