X

Xano-MCP 模型上下文协议服务器

@roboulos/xano-mcp
0 Stars 385 次浏览 roboulos 更新于 2026-08-23

一种模型上下文协议服务器,使 Claude AI 能够与 Xano 数据库交互,通过标准化接口提供全面的数据库操作、文件管理和请求历史跟踪。

该服务暂未提供标准配置,请参考 README 手动接入

服务介绍

Xano MCP 服务器用于 Smithery

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

本地安装

# Clone the repository
git clone https://github.com/roboulos/xano-mcp.git
cd xano-mcp

# Install dependencies
pip install -r requirements.txt

使用

本地运行

# Run with stdio transport (default)
python -m src.xano_mcp --token YOUR_XANO_API_TOKEN

# Run with WebSocket transport
python -m src.xano_mcp --token YOUR_XANO_API_TOKEN --transport websocket --port 8765

# Enable debug mode
python -m src.xano_mcp --token YOUR_XANO_API_TOKEN --debug

与 Smithery 一起使用

  1. 将 MCP 服务器部署到 Smithery:
smithery deploy
  1. 在 Smithery 仪表板中使用您的 Xano API 令牌配置服务器

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

# Build the Docker image
docker build -t xano-mcp .

# Run with stdio transport
docker run -e XANO_API_TOKEN=YOUR_TOKEN xano-mcp

# Run with WebSocket transport
docker run -e XANO_API_TOKEN=YOUR_TOKEN -p 8765:8765 xano-mcp --transport websocket --port 8765

许可证

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

相关 MCP 服务