Xano数据库集成服务器

一个用于将Xano数据库与Smithery集成的MCP服务器,使Claude AI能够与Xano数据库交互。

  • by roboulos
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 roboulos/xano-mcp

使用说明

Smithery的Xano MCP服务器

用于将Xano数据库与Smithery集成的模型上下文协议(MCP)服务器,使Claude AI能够与Xano数据库交互。

概述

此MCP服务器在Claude AI(通过Smithery)和Xano数据库之间提供了一个桥梁,允许Claude通过标准化的接口对Xano数据执行操作。服务器实现了模型上下文协议,使其与Smithery的无服务器部署模型兼容。

特性

  • 完成Xano API集成
  • 支持stdio和WebSocket传输方法
  • 全面的数据库操作(表、模式、记录)
  • 文件管理功能
  • 请求历史跟踪
  • 导入/导出功能

可用工具

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

实例和数据库操作

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

表操作

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

表架构操作

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

表索引操作

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

表内容操作

  • 浏览和搜索表格内容
  • 对记录执行CRUD操作(创建、读取、更新、删除)
  • 批量操作以提高效率

文件操作

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

请求历史操作

  • 浏览和搜索请求历史记录

工作区导入/导出

  • 导出和导入工作区和模式

安装

先决条件

  • Python 3.10或更高版本
  • Smithery CLI(用于部署)
  • Xano API代币

本地安装

# Clone the repository
git clone https://github.com/roboulos/xano-mcp.git
cd xano-mcp

# Install dependencies
pip install -r requirements.txt

用法

本地运行

# Run with stdio transport (default)
python -m src.xano_mcp --token YOUR_XANO_API_TOKEN

# Run with WebSocket transport
python -m src.xano_mcp --token YOUR_XANO_API_TOKEN --transport websocket --port 8765

# Enable debug mode
python -m src.xano_mcp --token YOUR_XANO_API_TOKEN --debug

与Smithery一起使用

  1. 将MCP服务器部署到Smithery:
smithery deploy
  1. 在Smithery仪表板中使用您的Xano API令牌配置服务器

  2. 在Smithery工作流中使用服务器

安全考虑

  • 安全存储您的Xano API代币
  • 尽可能对敏感信息使用环境变量
  • 考虑在Xano数据库上使用访问控制
  • MCP服务器可以完全访问您的Xano数据库,因此可以安全地部署它

配置

可以使用命令行参数或环境变量配置服务器:

选项 环境变量 描述
--令牌 XANO_API_token 您的XANO API令牌(必需)
--transport MCP_transport 传输方式:stdio或websocket(默认:stdio)
--端口 MCP_port WebSocket服务器的端口(默认值:8765)
--debug MCP_debug 启用详细日志记录的调试模式

Docker支持

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

# Build the Docker image
docker build -t xano-mcp .

# Run with stdio transport
docker run -e XANO_API_TOKEN=YOUR_TOKEN xano-mcp

# Run with WebSocket transport
docker run -e XANO_API_TOKEN=YOUR_TOKEN -p 8765:8765 xano-mcp --transport websocket --port 8765

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。