用于 Smithery 的 Xano MCP 服务器

一个用于集成 Xano 数据库与 Smithery 的模型上下文协议 (MCP) 服务器，使 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 令牌

本地安装

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

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

用法

本地运行

# 使用 stdio 传输（默认）运行
python -m src.xano_mcp --token YOUR_XANO_API_TOKEN

# 使用 WebSocket 传输运行
python -m src.xano_mcp --token YOUR_XANO_API_TOKEN --transport websocket --port 8765

# 启用调试模式
python -m src.xano_mcp --token YOUR_XANO_API_TOKEN --debug

与 Smithery 一起使用

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

smithery deploy

2. 在 Smithery 仪表板中使用您的 Xano API 令牌配置服务器

3. 在您的 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 运行服务器：

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

# 使用 stdio 传输运行
docker run -e XANO_API_TOKEN=YOUR_TOKEN xano-mcp

# 使用 WebSocket 传输运行
docker run -e XANO_API_TOKEN=YOUR_TOKEN -p 8765:8765 xano-mcp --transport websocket --port 8765

许可证

该项目已获得 MIT 许可证的许可 - 有关详细信息，请参阅 LICENSE 文件。