Xano模型上下文
通过模型上下文协议启用AI助手管理Xano数据库,允许用户创建、修改和删除表、编辑架构以及提取API文档。
服务介绍
Xano MCP 服务器
一个用于与 Xano 的元数据 API 交互的模型上下文协议 (MCP) 服务器。该服务器提供了可以通过 Cursor 或其他 MCP 兼容客户端使用的工具,供 AI 助手(如 Claude)使用。
特性
- 管理表:在您的 Xano 数据库中创建、列出和删除表
- 模式操作:查看和修改表模式,并具有全面的模式编辑功能
- 数据库管理:与您的 Xano 数据库结构进行交互的完整工具集
- Swagger 规范:以 JSON 或 Markdown(减少令牌)格式提取您的 API 组 API 详细信息
请注意,这是一个早期阶段项目,欢迎反馈和请求。
前提条件
- Node.js(v16 或更高版本)
- npm 或其他 Node.js 包管理器
- 具有 API 访问权限的 Xano 账户
- Cursor、Claude Desktop、Cline 或其他 MCP 客户端。
安装
- 克隆仓库:
git clone https://github.com/lowcodelocky2/xano-mcp.git
cd xano-mcp
- 安装依赖项:
npm install
-
配置您的 Xano 凭证:
- 编辑
index.ts并设置您的 Xano 凭证:XANO_API_KEY:您的 Xano API 密钥XANO_WORKSPACE:您的 Xano 工作区 IDXANO_API_BASE:您的 Xano 实例 API URL(例如,https://your-instance.xano.io/api:meta)
- 编辑
-
构建项目:
npm run build
与 Claude Desktop 一起使用
请参阅此指南 - https://modelcontextprotocol.io/quickstart/user
更新您的配置:
{
"mcpServers": {
"xano": {
"command": "node",
"args": [
"/path/to/xano-mcp"
]
}
}
}
将 /path/to/xano-mcp 替换为您的项目目录的绝对路径。
这不适用于 Claude 网页应用,仅通过桌面应用支持 - https://claude.ai/download
与 Cursor 一起使用
- 打开 Cursor
- 单击“添加 MCP 服务器”
- 配置服务器:
- 名称:
您想称呼它的任何名称 - 类型:
command - 命令:
node /path/to/xano-mcp/build/index.js
- 名称:
将 /path/to/xano-mcp 替换为您的项目目录的绝对路径。
示例 Mac
node /Users/your-user/Documents/folder-name/xano-mcp/build/index.js
如果您在您的目录内,可以在终端中运行命令 'pwd' 来获取绝对路径。
Xano MCP 工具概述
此集成通过模型上下文协议 (MCP) 提供了一套全面的工具来管理您的 Xano 工作区。您可以执行以下操作:
数据库管理
表
- 列出工作区中的所有表
- 查看详细的表模式
- 使用自定义模式创建新表
- 删除现有表
- 修改表模式(添加/删除/重命名列)
模式操作
- 添加具有各种数据类型的新列
- 删除列
- 重命名列
- 更新整个表模式
- 支持复杂的数据类型和关系
API 管理
API 组
- 创建新的 API 组
- 列出所有 API 组
- 浏览组内的 API
- 启用/禁用 Swagger 文档
- 管理 API 组元数据(标签、分支等)
单个 API
- 向组中添加新 API
- 配置 HTTP 方法 (GET, POST, PUT, DELETE, PATCH, HEAD)
- 设置 API 文档
- 添加元数据(标签、描述)
文档
- 以 markdown(减少的标记)和 JSO(完整)格式生成 API 组规范
- 查看 Swagger 文档
- 访问详细的模式信息
这套工具使您可以完全管理 Xano 工作区,通过 MCP 接口以编程方式构建和维护您的后端基础设施。
重新启用删除表工具
要在此代码库中重新启用删除表功能,请按照以下步骤操作:
-
在代码编辑器中打开文件
src/index.ts -
找到以以下内容开始的注释部分:
// Delete Table Tool /* server.tool(并以以下内容结束:
); */ -
要取消注释此部分:
- 删除 "Delete Table Tool" 后面行上的开头
/* - 删除 "Edit Table Schema Tool" 前面的结尾
*/
完成!删除表工具现在将再次激活。(在运行新的构建之后)
- 删除 "Delete Table Tool" 后面行上的开头
代码示例
// Delete Table Tool
server.tool(
"delete-table",
"Delete a table from the Xano workspace",
{
table_id: z.string().describe("ID of the table to delete")
},
async ({ table_id }) => {
// ... rest of the implementation
}
);
验证
进行这些更改后:
- 保存文件
- 运行新的构建
npm run build - 重启您的 MCP 客户端(Claude / Cursor)
- 现在您的工具集中应该可以使用删除表工具了
安全提示
删除表工具会永久从您的 Xano 工作区中移除表。在使用此功能之前,请确保您有适当的备份。