使用说明
Xano MCP服务器
用于与Xano的元数据API交互的模型上下文协议(MCP)服务器。该服务器提供了AI助手(如Claude)可以通过Cursor或其他MCP兼容客户端使用的工具。
特性
- 管理表:在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
使用游标
- 打开的游标
- 点击“添加MCP服务器”
- 配置服务器:
- 姓名:
whatever you want to call it - 类型:
command - 命令:
node /path/to/xano-mcp/build/index.js
- 姓名:
替换 /path/to/xano-mcp 带有项目目录的绝对路径。
mac示例
node/用户/你的用户/文档/文件夹名/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
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工作区中永久删除表。在使用此功能之前,请确保您有适当的备份。