Xano

🚀 Xano MCP 服務器用於 Smithery

此項目是一個模型上下文協議（MCP）服務器，旨在將 Xano 數據庫與 Smithery 集成，讓 Claude AI 能夠與 Xano 數據庫進行交互，為數據操作提供便利。

🚀 快速開始

此 MCP 服務器為 Claude AI（通過 Smithery）和 Xano 數據庫之間架起橋樑，允許 Claude 通過標準化接口執行對 Xano 數據的操作。該服務器實現了模型上下文協議，使其與 Smithery 的無服務部署模式兼容。

✨ 主要特性

• 完整的 Xano API 集成
• 支持標準輸入輸出（stdio）和 WebSocket 傳輸方法
• 全面的數據庫操作（表、架構、記錄）
• 文件管理功能
• 請求歷史跟蹤
• 導入/導出功能

📦 安裝指南

依賴項

• 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 您的 Xano API 令牌

# 使用 WebSocket 傳輸運行
python -m src.xano_mcp --token 您的 Xano API 令牌 --transport websocket --port 8765

# 啟用調試模式
python -m src.xano_mcp --token 您的 Xano API 令牌 --debug

與 Smithery 使用

1. 將 MCP 服務器部署到 Smithery：

smithery deploy

2. 在 Smithery 儀表板中配置服務器，使用您的 Xano API 令牌
3. 在 Smithery 工作流中使用該服務器

高級用法

Docker 支持

您可以使用 Docker 運行服務器：

# 構建 Docker 鏡像
docker build -t xano-mcp .

# 使用默認 stdio 傳輸運行
docker run -e XANO_API_TOKEN=您的令牌 xano-mcp

# 使用 WebSocket 傳輸運行
docker run -e XANO_API_TOKEN=您的令牌 --name xano-mcp-container -p 8765:8765 xano-mcp

📚 詳細文檔

可用工具

該服務器提供以下類別的工具：

實例和數據庫操作

• 列出 Xano 實例
• 獲取實例詳細信息
• 列出數據庫/工作區
• 獲取工作區詳細信息

表操作

• 列出表格
• 獲取表詳細信息
• 創建、更新和刪除表

表架構操作

• 獲取和更新表架構
• 添加、重命名和刪除字段

表索引操作

• 列出、創建和刪除各種索引類型（btree、唯一、搜索、空間、向量）

表內容操作

• 搜索表內容
• 對記錄執行 CRUD 操作（創建、讀取、更新、刪除）
• 批量操作以提高效率

文件操作

• 列出、上傳和刪除文件
• 獲取文件詳細信息

請求歷史操作

• 瀏覽和搜索請求歷史

工作區導入/導出

• 導出和導入工作區和架構

配置

服務器可以通過命令行參數或環境變量進行配置：

🔧 技術細節

此 MCP 服務器實現了模型上下文協議，為 Claude AI（通過 Smithery）和 Xano 數據庫之間提供了標準化接口，使其能夠與 Smithery 的無服務部署模式兼容，允許 Claude 通過該接口執行對 Xano 數據的操作。

⚠️ 重要提示

• 安全存儲您的 Xano API 令牌
• 儘可能在環境變量中使用敏感信息
• 考慮對您的 Xano 數據庫使用訪問控制
• 該 MCP 服務器對您的 Xano 數據庫具有完全訪問權限，因此請安全部署

📄 許可證

通過此 MCP 服務器，您可以方便地將 Claude AI 與 Xano 數據庫集成，充分發揮兩者的潛力。