Java based Model Context Procotol (MCP) Server for JDBC
2025.04.16
0
Java数据库管理数据库查询数据分析数据库
mcp-jdbc-server 是一个基于 Java 的轻量级 MCP（Model Context Protocol）服务器，专为 JDBC 设计。该服务器兼容 Virtuoso DBMS 以及其他具有 JDBC 驱动的数据库后端。它提供了丰富的数据库操作功能，包括获取数据库模式、表结构描述、执行查询和存储过程等。
View on GitHub
Overview
基本能力
产品定位
mcp-jdbc-server 是一个专为 JDBC 设计的轻量级 MCP 服务器，主要用于与数据库后端进行交互，提供丰富的数据库操作功能。
核心功能
- 获取模式：从连接的数据库中获取并列出所有模式名称。
- 获取表：检索特定模式或所有模式的表信息。
- 描述表：生成表结构的详细描述，包括列名、数据类型、可为空属性、主键和外键。
- 搜索表：基于名称子字符串过滤和检索表。
- 执行存储过程：在 Virtuoso 的情况下，执行存储过程并检索结果。
- 执行查询：
- JSONL 结果格式：优化结构化响应。
- Markdown 表格格式：适合报告和可视化。
适用场景
- 数据库管理和维护
- 数据库查询和数据分析
- 数据库模式探索和文档生成
- 与 Virtuoso DBMS 的交互
工具列表
- jdbc_get_schemas：列出数据库模式。
- jdbc_get_tables：列出指定模式的表信息。
- jdbc_describe_table：描述表结构。
- jdbc_filter_table_names：基于子字符串过滤表名。
- jdbc_query_database：执行 SQL 查询并返回 JSON 结果。
- jdbc_execute_query：执行 SQL 查询并返回 JSONL 结果。
- jdbc_execute_query_md：执行 SQL 查询并返回 Markdown 表格结果。
- jdbc_spasql_query：执行 SPASQL 查询（Virtuoso 特有）。
- jdbc_sparql_query：执行 SPARQL 查询（Virtuoso 特有）。
- jdbc_virtuoso_support_ai：与 Virtuoso 支持助手交互（Virtuoso 特有）。
常见问题解答
- 安装 MCP Inspector 进行故障排除：
bash npm install -g @modelcontextprotocol/inspector npx @modelcontextprotocol/inspector java -jar /path/to/mcp-jdbc-server/MCPServer-1.0.0-runner.jar
使用教程
使用依赖
- Java 21 或更高版本。
安装教程
- 克隆仓库：
bash git clone https://github.com/OpenLinkSoftware/mcp-jdbc-server.git cd mcp-jdbc-server - 更新
.env文件：jdbc.url=jdbc:virtuoso://localhost:1111 jdbc.user=dba jdbc.password=dba jdbc.api_key=xxx - 配置 Claude Desktop（可选）：
json { "mcpServers": { "my_database": { "command": "java", "args": ["-jar", "/path/to/mcp-jdbc-server/MCPServer-1.0.0-runner.jar"], "env": { "jdbc.url": "jdbc:virtuoso://localhost:1111", "jdbc.user": "username", "jdbc.password": "password", "jdbc.api_key": "sk-xxx" } } } }
调试方式
- 安装 MCP Inspector：
bash npm install -g @modelcontextprotocol/inspector - 启动 Inspector：
bash npx @modelcontextprotocol/inspector java -jar /path/to/mcp-jdbc-server/MCPServer-1.0.0-runner.jar - 访问提供的 URL 进行服务器交互故障排除。