AI导哈

Xano MCP Python SDK

一个基于Python的MCP（模型上下文协议）服务器，用于Xano，允许AI助手如Claude直接与您的Xano实例交互。这是一个优化用于本地使用的独立版本。

  • by roboulos
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 roboulos/simple-xano-mcp

使用说明

Xano MCP Python SDK

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

🌟 特性

  • 简单身份验证：连接您的Xano API令牌
  • 综合API：查询和操作Xano实例、数据库、表和记录
  • 本地部署：作为Claude Desktop或其他客户端的本地MCP服务器运行
  • 详细日志记录：使用综合日志解决问题
  • 便携的：适用于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桌面 （如果使用）：

    编辑您的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"
      }
    }
  }
}

  4. 运行安装脚本:

    # On macOS/Linux
./install.sh

# On Windows
install.bat

  5. 测试安装:

    ./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

🚨 故障排除

如果您遇到问题：

  1. 检查日志 对于错误：

    # macOS
tail -n 100 -f ~/Library/Logs/Claude/mcp*.log

# Windows
type "%APPDATA%\Claude\logs\mcp*.log"

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

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

  4. 确保Python环境 设置正确

🤝 贡献

欢迎投稿！请随时提交拉取请求。

📄 许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

🙏 致谢

  • Xano的优秀数据库平台
  • 模型上下文协议规范的拟人化
  • 帮助改进此SDK的贡献者和测试人员

相关 MCP