数据库管理工具

Xano MCP Server是一个用于与Xano元数据API交互的模型上下文协议服务器,提供数据库表管理、模式操作和API管理等功能,适用于AI助手和MCP兼容客户端。

  • by lowcodelocky2
  • TypeScript
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 lowcodelocky2/xano-mcp

使用说明

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客户端。

安装

  1. 克隆存储库:
git clone https://github.com/lowcodelocky2/xano-mcp.git
cd xano-mcp
  1. 安装依赖项:
npm install
  1. 配置您的Xano凭据:

    • 编辑 index.ts 并设置您的Xano凭据:
      • XANO_API_KEY:您的Xano API密钥
      • XANO_WORKSPACE:您的Xano工作区ID
      • XANO_API_BASE:您的Xano实例API URL(例如。,https://your-instance.xano.io/api:meta)
  2. 构建项目:

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

使用游标

  1. 打开的游标
  2. 点击“添加MCP服务器”
  3. 配置服务器:
    • 姓名: 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接口以编程方式构建和维护后端基础设施。

重新启用删除表格工具

要在此代码库中重新启用删除表功能,请按照以下分步说明操作:

  1. 打开文件 src/index.ts 在代码编辑器中

  2. 找到以以下内容开头的注释部分:

    // Delete Table Tool
    /*
    server.tool(
    

    并以以下内容结束:

    );
    */
    
  3. 取消对本节的注释:

    • 删除开口 /* 在“删除表格工具”之后的行上
    • 删除关闭 */ 在“编辑表架构工具”之前

    就是这样!删除表格工具现在将再次处于活动状态。(运行新版本后)

代码之后应该是什么样子的示例

// 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
  }
);

验证

进行这些更改后:

  1. 保存文件
  2. 运行一个新的构建` npm Run build'
  3. 重新启动MCP客户端(Claude/Cursor)
  4. 删除表工具现在应该可以在您的工具集中使用

安全注意事项

删除表工具会从Xano工作区中永久删除表。在使用此功能之前,请确保您有适当的备份。