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
- -securityAlicense-qualityA Model Context Protocol server that allows Claude to interact with Linear's API for managing teams, issues, projects, and cycles.Last updated -192TypeScriptMIT License
- -securityAlicense-qualityA Model Context Protocol server that enables Claude AI to interact with Xano databases, providing comprehensive database operations, file management, and request history tracking through a standardized interface.Last updated -1PythonMIT License
- -securityAlicense-qualityA Model Context Protocol server that enables Claude to interact directly with Contentful CMS, allowing the AI to fetch content types and entries from a Contentful space.Last updated -2TypeScriptMIT License
- AsecurityFlicenseAqualityA Model Context Protocol server that allows integration with Claude Desktop by creating and managing custom tools that can be executed through the MCP framework.Last updated -423TypeScript