Xano

🚀 Xano MCP 服务器用于 Smithery

本项目是一个模型上下文协议（MCP）服务器，旨在将 Xano 数据库与 Smithery 集成，从而让 Claude AI 能够与 Xano 数据库进行交互，为数据操作提供便利。

🚀 快速开始

此 MCP 服务器在 Claude AI（通过 Smithery）和 Xano 数据库之间搭建了桥梁，允许 Claude 通过标准化接口对 Xano 数据执行操作。该服务器实现了模型上下文协议，与 Smithery 的无服务部署模式相兼容。

✨ 主要特性

• 实现完整的 Xano API 集成。
• 支持标准输入输出（stdio）和 WebSocket 两种传输方法。
• 具备全面的数据库操作能力，涵盖表、架构、记录等方面。
• 拥有文件管理功能。
• 可对请求历史进行跟踪。
• 具备导入/导出功能。

📦 安装指南

依赖项

• 需要 Python 3.10 或更高版本。
• 需安装 Smithery CLI（用于部署）。
• 准备好 Xano API 令牌。

本地安装

# 克隆仓库
git clone https://github.com/roboulos/xano-mcp.git
cd xano-mcp

# 安装依赖项
pip install -r requirements.txt

💻 使用示例

本地运行

# 使用默认 stdio 传输运行
python -m src.xano_mcp --token 您的 Xano API 令牌

# 使用 WebSocket 传输运行
python -m src.xano_mcp --token 您的 Xano API 令牌 --transport websocket --port 8765

# 启用调试模式
python -m src.xano_mcp --token 您的 Xano API 令牌 --debug

与 Smithery 使用

1. 将 MCP 服务器部署到 Smithery：

smithery deploy

2. 在 Smithery 仪表板中配置服务器，使用您的 Xano API 令牌。
3. 在 Smithery 工作流中使用该服务器。

📚 详细文档

可用工具

该服务器提供以下类别的工具：

实例和数据库操作

• 列出 Xano 实例。
• 获取实例详细信息。
• 列出数据库/工作区。
• 获取工作区详细信息。

表操作

• 列出表格。
• 获取表详细信息。
• 创建、更新和删除表。

表架构操作

• 获取和更新表架构。
• 添加、重命名和删除字段。

表索引操作

• 列出、创建和删除各种索引类型（btree、唯一、搜索、空间、向量）。

表内容操作

• 搜索表内容。
• 对记录执行 CRUD 操作（创建、读取、更新、删除）。
• 支持批量操作以提高效率。

文件操作

• 列出、上传和删除文件。
• 获取文件详细信息。

请求历史操作

• 浏览和搜索请求历史。

工作区导入/导出

• 导出和导入工作区和架构。

配置

服务器可以通过命令行参数或环境变量进行配置：

Docker 支持

您可以使用 Docker 运行服务器：

# 构建 Docker 镜像
docker build -t xano-mcp .

# 使用默认 stdio 传输运行
docker run -e XANO_API_TOKEN=您的令牌 xano-mcp

# 使用 WebSocket 传输运行
docker run -e XANO_API_TOKEN=您的令牌 --name xano-mcp-container -p 8765:8765 xano-mcp

安全注意事项

• 安全存储您的 Xano API 令牌。
• 尽可能在环境变量中使用敏感信息。
• 考虑对您的 Xano 数据库使用访问控制。
• 该 MCP 服务器对您的 Xano 数据库具有完全访问权限，因此请安全部署。

📄 许可证

通过此 MCP 服务器，您可以方便地将 Claude AI 与 Xano 数据库集成，充分发挥两者的潜力。