Nile MCP Server

基本能力

产品定位

Nile MCP Server 是一个为 Nile 数据库平台实现的模型上下文协议（MCP）服务器，旨在通过标准化接口连接 LLM 应用程序与 Nile 数据库平台。

核心功能

• 数据库管理：创建、列出、获取详情和删除数据库
• 凭证管理：创建和列出数据库凭证
• 区域管理：列出可用于创建数据库的区域
• SQL 查询支持：直接在 Nile 数据库上执行 SQL 查询
• MCP 协议支持：完整实现模型上下文协议
• 类型安全：使用 TypeScript 编写，具有完整的类型检查
• 错误处理：全面的错误处理和用户友好的错误消息
• 测试覆盖：使用 Jest 的全面测试套件
• 环境管理：自动从 .env 文件加载环境变量
• 输入验证：基于 Zod 的输入验证

适用场景

• LLM 应用程序与 Nile 数据库的交互
• 数据库管理和操作自动化
• SQL 查询执行和结果分析
• 多租户数据库管理

工具列表

1. create-database：创建新数据库
2. list-databases：列出所有数据库
3. get-database：获取数据库详情
4. delete-database：删除数据库
5. list-credentials：列出数据库凭证
6. create-credential：创建新凭证
7. list-regions：列出可用区域
8. execute-sql：执行 SQL 查询
9. read-resource：读取资源模式信息
10. list-resources：列出所有资源
11. list-tenants：列出所有租户
12. create-tenant：创建新租户
13. delete-tenant：删除租户

常见问题解答

1. 无法访问工具：检查服务器路径、API 密钥和工作区 slug 是否正确
2. 数据库创建失败：检查 API 密钥权限、数据库名称唯一性和区域支持
3. 凭证操作失败：验证数据库状态和 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

启动服务器

1. 直接执行： bash node dist/index.js
2. 开发模式： bash 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_API_KEY=your_api_key_here
NILE_WORKSPACE_SLUG=your_workspace_slug

许可证

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