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一起使用
- 将MCP服务器部署到Smithery:
smithery deploy- 在Smithery仪表板中使用您的Xano API令牌配置服务器
- 在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许可证获得许可-请参阅 许可证 文件以获取详细信息。
