Xano MCP 服务器

一个用于与 Xano 元数据 API 交互的模型上下文协议 (MCP) 服务器。此服务器提供可供 AI 助手（如 Claude）通过 Cursor 或其他 MCP 兼容客户端使用的工具。

功能

• 管理表格: 在您的 Xano 数据库中创建、列出和删除表格
• 模式操作: 查看和修改表格模式，具有全面的模式编辑功能
• 数据库管理: 用于与您的 Xano 数据库结构交互的完整工具集
• Swagger 规范: 以 JSON 或 Markdown（减少 token）格式提取您的 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

2. 安装依赖项：

npm install

3. 配置您的 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）

4. 构建项目：

npm run build

与 Claude Desktop 一起使用

请遵循本指南 - https://modelcontextprotocol.io/quickstart/user

使用以下内容更新您的配置：

{
  "mcpServers": {
    "xano": {
      "command": "node",
      "args": [
        "/path/to/xano-mcp"
      ]
    }
  }
} 

将 /path/to/xano-mcp 替换为您的项目目录的绝对路径。

这不适用于 Claude Web 应用程序，仅适用于桌面应用程序 - https://claude.ai/download

与 Cursor 一起使用

1. 打开 Cursor
2. 单击“添加 MCP 服务器”
3. 配置服务器：
   • 名称：随便你叫什么
   • 类型：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（减少 token）和 JSO（完整）格式生成 API 组规范
• 查看 Swagger 文档
• 访问详细的模式信息

此工具集可以完全管理您的 Xano 工作区，使您能够通过 MCP 接口以编程方式构建和维护您的后端基础设施。

重新启用删除表格工具

要在此代码库中重新启用 delete-table 功能，请按照以下分步说明进行操作：

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

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

   // Delete Table Tool
   /*
   server.tool(
   

   并以以下内容结尾：

   );
   */
   

3. 要取消注释此部分：

   • 删除“Delete Table Tool”后一行的开头的 /*
   • 删除“Edit Table Schema Tool”之前的结尾的 */

   就这样！delete-table 工具现在将再次激活。（在运行新的构建之后）

代码应如下所示的示例

// Delete Table Tool
server.tool(
  "delete-table",
  "从 Xano 工作区删除表格",
  {
    table_id: z.string().describe("要删除的表格的 ID")
  },
  async ({ table_id }) => {
    // ... 其余实现
  }
);

验证

进行这些更改后：

1. 保存文件
2. 运行新的构建 `npm run build'
3. 重新启动您的 MCP 客户端 (Claude / Cursor)
4. delete-table 工具现在应该在您的工具集中可用

安全提示

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