Xano MCP Python SDK
Xano的基于Python的MCP（模型上下文协议）服务器，允许像Claude这样的AI助手直接与您的Xano实例交互。这是一个独立版本，针对Claude Desktop和其他兼容MCP的LLM的本地使用进行了优化。
🌟 特性
- 简单身份验证：连接您的Xano API令牌
- 综合API：查询和操作Xano实例、数据库、表和记录
- 本地部署：作为Claude Desktop或其他客户端的本地MCP服务器运行
- 详细日志记录：使用综合日志解决问题
- 便携的：适用于macOS、Windows和Linux
🚀 快速开始
- 克隆此存储库:
git clone https://github.com/yourusername/xano-mcp-python.git
cd xano-mcp-python- 安装依赖项:
pip install -r requirements.txt- 配置Claude桌面 （如果使用）：
编辑您的Claude Desktop配置文件：
- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json
添加此配置：
{
"mcpServers": {
"xano": {
"command": "python",
"args": [
"/path/to/xano-mcp-python/xano_mcp_sdk.py"
],
"env": {
"XANO_API_TOKEN": "your-xano-api-token"
}
}
}
}- 运行安装脚本:
# On macOS/Linux
./install.sh
# On Windows
install.bat- 测试安装:
./test.py💡 使用示例
安装后，您可以将其与Claude或任何兼容MCP的助手一起使用。以下是一些示例：
- 列出您的Xano实例:
> 我有哪些Xano实例？
- 检查数据库表:
> 显示Xano实例“my instance”中的所有表
- 创建新表:
> 在我的Xano实例“my instance”中创建一个名为“products”的新表
- 检查表结构:
> “users”表的模式是什么？
- 查询记录:
> 显示“用户”表中的前5条记录
🧰 可用工具
实例管理
- 列出实例
- 获取实例详细信息
- 检查实例状态
数据库操作
- 列出数据库/工作区
- 获取工作区详细信息
- 数据库模式管理
表操作
- 创建、更新、删除表
- 添加、修改和删除字段
- 指标管理
记录管理
- 创建、读取、更新、删除记录
- 批量操作
- 复杂查询
文件操作
- 列出和管理文件
- 上传和下载
API工具
- API集团管理
- API端点创建和配置
🔧 高级配置
环境变量
XANO_API_TOKEN：您的Xano API令牌（必需）XANO_LOG_LEVEL：设置日志级别（默认值：INFO）XANO_DEFAULT_INSTANCE：未指定时使用的默认实例
命令行选项
python xano_mcp_sdk.py --token YOUR_TOKEN --log-level DEBUG日志记录
日志将写入：
- macOS：
~/Library/Logs/Claude/mcp*.log - 窗户：
%APPDATA%\Claude\logs\mcp*.log
对于直接控制台输出，运行：
python xano_mcp_sdk.py --console-logging🚨 故障排除
如果您遇到问题：
- 检查日志 对于错误：
# macOS
tail -n 100 -f ~/Library/Logs/Claude/mcp*.log
# Windows
type "%APPDATA%\Claude\logs\mcp*.log"- 验证API令牌 正确且具有适当的权限
- 检查网络连接 到Xano服务器
- 确保Python环境 设置正确
🤝 贡献
欢迎投稿！请随时提交拉取请求。
📄 许可证
此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。
🙏 致谢
- Xano的优秀数据库平台
- 模型上下文协议规范的拟人化
- 帮助改进此SDK的贡献者和测试人员