Xano MCP Python SDK

基于Python的MCP（模型上下文协议）服务器，适用于Xano，允许像Claude这样的AI助手直接与您的Xano实例交互。这是一个优化用于本地使用的独立版本，适用于Claude Desktop和其他兼容MCP的大规模语言模型（LLMs）。

🌟 特性

• 简单认证：通过Xano API令牌连接
• 全面API：查询和操作Xano实例、数据库、表和记录
• 本地部署：作为本地MCP服务器运行，适用于Claude Desktop或其他客户端
• 详细日志：通过详尽的日志进行故障排除
• 便携性：在macOS、Windows和Linux上运行

🚀 快速开始

1. 克隆此仓库：

   git clone https://github.com/yourusername/xano-mcp-python.git
   cd xano-mcp-python
   

2. 安装依赖项：

   pip install -r requirements.txt
   

3. 配置Claude Desktop（如果使用）：

   编辑您的Claude Desktop配置文件：

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %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"
         }
       }
     }
   }
   

4. 运行安装脚本：

   # 在macOS/Linux上
   ./install.sh
   
   # 在Windows上
   install.bat
   

5. 测试安装：

   ./test.py
   

💡 使用示例

安装后，您可以使用它与Claude或任何兼容MCP的助手一起工作。这里有一些示例：

• 列出您的Xano实例：

  我有哪些Xano实例？

• 检查数据库表：

  显示我在Xano实例“my-instance”中的所有表

• 创建新表：

  在我的Xano实例“my-instance”中创建一个名为“products”的新表

• 查看表结构：

  “users”表的模式是什么？

• 查询记录：

  显示“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
• Windows: %APPDATA%\Claude\logs\m.mcp*.log

要直接输出到控制台，请运行：

python xano_mcp_sdk.py --console-logging

🚨 故障排除

如果您遇到问题：

1. 检查日志中的错误：

   # macOS
   tail -n 100 -f ~/Library/Logs/Claude/mcp*.log
   
   # Windows
   type "%APPDATA%\Claude\logs\mcp*.log"
   

2. 验证API令牌是否正确且具有适当的权限

3. 检查网络连接到Xano服务器

4. 确保Python环境已正确设置

🤝 贡献

欢迎贡献！请随时提交Pull Request。

📄 许可证

本项目根据MIT许可证发布 - 查看LICENSE文件以获取详细信息。

🙏 致谢

• Xano，感谢他们优秀的数据库平台
• Anthropic，感谢他们提供的模型上下文协议规范
• 贡献者和测试人员，他们帮助完善了这个SDK