
Nile MCP Server

2025.03.24
0
TypeScript数据库管理SQL 查询多租户管理数据库
Nile MCP Server 是一个为 Nile 数据库平台实现的模型上下文协议(MCP)服务器。该服务器允许 LLM 应用程序通过标准化接口与 Nile 平台进行交互。其主要功能包括数据库管理、凭证管理、区域管理、SQL 查询支持等,适用于需要与 Nile 数据库进行交互的各种场景。
View on GitHub
Overview
基本能力
产品定位
Nile MCP Server 是一个为 Nile 数据库平台实现的模型上下文协议(MCP)服务器,旨在为 LLM 应用程序提供与 Nile 数据库交互的标准化接口。
核心功能
- 数据库管理:创建、列出、获取详情和删除数据库
- 凭证管理:创建和列出数据库凭证
- 区域管理:列出可用于创建数据库的区域
- SQL 查询支持:直接在 Nile 数据库上执行 SQL 查询
- MCP 协议支持:完整的模型上下文协议实现
- 类型安全:使用 TypeScript 编写,具有完整的类型检查
- 错误处理:全面的错误处理和用户友好的错误消息
- 测试覆盖:使用 Jest 的全面测试套件
- 环境管理:从 .env 文件自动加载环境变量
- 输入验证:使用 Zod 进行基于模式的输入验证
适用场景
- 需要与 Nile 数据库进行交互的 LLM 应用程序
- 数据库管理和操作自动化
- SQL 查询执行和结果分析
- 多租户数据库管理
工具列表
- create-database:创建新的 Nile 数据库
- list-databases:列出工作区中的所有数据库
- get-database:获取特定数据库的详细信息
- delete-database:删除数据库
- list-credentials:列出数据库的所有凭证
- create-credential:为数据库创建新凭证
- list-regions:列出可用于创建数据库的所有区域
- execute-sql:在 Nile 数据库上执行 SQL 查询
- read-resource:读取数据库资源(表、视图等)的模式信息
- list-resources:列出数据库中的所有资源
- list-tenants:列出数据库中的所有租户
- create-tenant:在数据库中创建新租户
- delete-tenant:删除数据库中的租户
常见问题解答
- Claude 无法访问工具:检查配置中的服务器路径是否正确,确保项目已构建,验证 API 密钥和工作区 slug 是否正确,重启 Claude Desktop。
- 数据库创建失败:检查 API 密钥权限,确保数据库名称在工作区中唯一,验证区域是否为支持的选项之一。
- 凭证操作失败:验证数据库是否存在且处于 READY 状态,检查 API 密钥是否具有必要的权限。
使用教程
使用依赖
确保已安装 Node.js 和 npm。
安装教程
安装稳定版本:
npm install @niledatabase/nile-mcp-server
安装最新 alpha/preview 版本:
npm install @niledatabase/nile-mcp-server@alpha
手动安装:
git clone https://github.com/yourusername/nile-mcp-server.git
cd nile-mcp-server
npm install
npm run build
调试方式
启动服务器:
node dist/index.js
开发模式(带自动重建):
npm run dev
验证服务器是否运行:
[info] Starting Nile MCP Server...
[info] Loading environment variables...
[info] Environment variables loaded successfully
[info] Creating server instance...
[info] Tools initialized successfully
[info] Setting up stdio transport...
[info] Server started successfully
配置:
创建 .env
文件并添加 Nile 凭证:
NILE_API_KEY=your_api_key_here
NILE_WORKSPACE_SLUG=your_workspace_slug