Xano MCP Python SDK
A Python-based MCP (Model Context Protocol) server for Xano that allows AI assistants like Claude to interact directly with your Xano instance. This is a standalone version optimized for local use with Claude Desktop and other MCP-compatible LLMs.
🌟 Features
- Simple Authentication: Connect with your Xano API token
- Comprehensive API: Query and manipulate Xano instances, databases, tables, and records
- Local Deployment: Run as a local MCP server for Claude Desktop or other clients
- Detailed Logging: Troubleshoot issues with comprehensive logging
- Portable: Works on macOS, Windows, and Linux
🚀 Quick Start
- Clone this repository:
- Install dependencies:
- Configure Claude Desktop (if using):Edit your Claude Desktop config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
Add this configuration:
- macOS:
- Run the installation script:
- Test the installation:
💡 Usage Examples
Once installed, you can use it with Claude or any MCP-compatible assistant. Here are some examples:
- List your Xano instances:
What Xano instances do I have?
- Check database tables:
Show me all tables in my Xano instance "my-instance"
- Create a new table:
Create a new table called "products" in my Xano instance "my-instance"
- Examine table structure:
What's the schema for the "users" table?
- Query records:
Show me the first 5 records in the "users" table
🧰 Available Tools
Instance Management
- List instances
- Get instance details
- Check instance status
Database Operations
- List databases/workspaces
- Get workspace details
- Database schema management
Table Operations
- Create, update, delete tables
- Add, modify, and remove fields
- Index management
Record Management
- Create, read, update, delete records
- Bulk operations
- Complex queries
File Operations
- List and manage files
- Upload and download
API Tools
- API group management
- API endpoint creation and configuration
🔧 Advanced Configuration
Environment Variables
XANO_API_TOKEN
: Your Xano API token (required)XANO_LOG_LEVEL
: Set log level (default: INFO)XANO_DEFAULT_INSTANCE
: Default instance to use when not specified
Command Line Options
Logging
Logs are written to:
- macOS:
~/Library/Logs/Claude/mcp*.log
- Windows:
%APPDATA%\Claude\logs\mcp*.log
For direct console output, run:
🚨 Troubleshooting
If you encounter issues:
- Check logs for errors:
- Verify API token is correct and has appropriate permissions
- Check network connectivity to Xano servers
- Ensure Python environment is properly set up
🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🙏 Acknowledgements
- Xano for their excellent database platform
- Anthropic for the Model Context Protocol specification
- Contributors and testers who helped refine this SDK
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A simplified Model Context Protocol server that enables Claude to interact with Xano databases through the Xano Metadata API.
Related MCP Servers
- AsecurityFlicenseAqualityEnables interaction with the Xano API through a Model Context Protocol (MCP) interface, providing secure and type-safe management of Xano database operations.Last updated -6TypeScript
- -securityFlicense-qualityA Model Context Protocol server built with mcp-framework that allows users to create and manage custom tools for processing data, integrating with the Claude Desktop via CLI.Last updated -484TypeScript
- -securityFlicense-qualityEnables AI assistants to manage Xano databases through the Model Context Protocol, allowing users to create, modify, and delete tables, edit schemas, and extract API documentation.Last updated -6TypeScript
- AsecurityAlicenseAqualityA collection of Model Context Protocol servers that enable Claude Desktop to provide development assistance capabilities with filesystem, Git, shell command, and web search functionality without incurring API usage costs.Last updated -214TypeScriptMIT License