Xano-MCP 模型上下文协议服务器
一种模型上下文协议服务器,使 Claude AI 能够与 Xano 数据库交互,通过标准化接口提供全面的数据库操作、文件管理和请求历史跟踪。
服务介绍
Xano MCP 服务器用于 Smithery
一个模型上下文协议 (MCP) 服务器,用于将 Xano 数据库与 Smithery 集成,使 Claude AI 能够通过标准化接口与 Xano 数据库进行交互。
概述
此 MCP 服务器提供了 Claude AI(通过 Smithery)和 Xano 数据库之间的桥梁,允许 Claude 通过标准化接口对 Xano 数据执行操作。该服务器实现了模型上下文协议,使其与 Smithery 的无服务器部署模型兼容。
特性
- 完整的 Xano API 集成
- 支持 stdio 和 WebSocket 传输方法
- 全面的数据库操作(表、模式、记录)
- 文件管理功能
- 请求历史跟踪
- 导入/导出功能
可用工具
服务器提供以下类别的工具:
实例和数据库操作
- 列出 Xano 实例
- 获取实例详情
- 列出数据库/工作区
- 获取工作区详情
表操作
- 列出表
- 获取表详情
- 创建、更新和删除表
表模式操作
- 获取和更新表模式
- 添加、重命名和删除字段
表索引操作
- 列出、创建和删除各种索引类型(btree、unique、search、spatial、vector)
表内容操作
- 浏览和搜索表内容
- 对记录进行 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 一起使用
- 将 MCP 服务器部署到 Smithery:
smithery deploy
-
在 Smithery 仪表板中使用您的 Xano API 令牌配置服务器
-
在您的 Smithery 工作流中使用该服务器
安全注意事项
- 安全地存储您的 Xano API 令牌
- 尽可能使用环境变量来存储敏感信息
- 考虑在您的 Xano 数据库上使用访问控制
- MCP 服务器对您的 Xano 数据库具有完全访问权限,因此请安全地部署它
配置
服务器可以使用命令行参数或环境变量进行配置:
| 选项 | 环境变量 | 描述 |
|---|---|---|
| --token | XANO_API_TOKEN | 您的 Xano API 令牌(必需) |
| --transport | MCP_TRANSPORT | 传输方法:stdio 或 websocket(默认:stdio) |
| --port | 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 许可证许可 - 有关详细信息,请参阅 LICENSE 文件。