MCP Server for Spanner

基本能力

产品定位

MCP Server for Spanner 是一个专门用于与 Google Cloud Spanner 数据库交互的工具，主要服务于 AI 助手等需要与数据库进行交互的应用场景。

核心功能

• 执行 SELECT 查询
• 执行数据更新操作（INSERT, UPDATE, DELETE）
• 执行 DDL 操作（CREATE TABLE, ALTER TABLE 等）
• 获取数据库中的表列表
• 显示指定表的结构详情

适用场景

• AI 助手与数据库的交互
• 数据库开发和测试
• 数据库结构管理和查询

工具列表

1. read_query: 执行 SELECT 查询
2. list_tables: 获取数据库中的表列表
3. describe_table: 显示指定表的结构
4. execute_ddl: 执行 DDL 查询
5. execute_write: 执行更新操作（INSERT, UPDATE, DELETE）

常见问题解答

• 目前仅支持 Spanner 模拟器的连接。

使用教程

使用依赖

• Node.js 22 以上
• Spanner 模拟器或 devcontainer 环境

安装教程

# 克隆仓库
git clone <repository-url>
cd mcp-server-spanner

# 安装依赖
npm install

# 构建 TypeScript
npm run build

调试方式

# 以 MCP 协议形式启动服务器
npm run inspect

# 使用环境变量指定连接信息
export PROJECT_ID=your-project-id
export INSTANCE_ID=your-instance-id
export DATABASE_ID=your-database-id
export API_ENDPOINT=localhost:9010
npm run inspect

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。