mcp-oceanbase

<div align="center"> # 🌊 Awesome OceanBase MCP **Model Context Protocol (MCP) Server Collection for OceanBase Ecosystem** English | [简体中文](README_CN.md) [](LICENSE) [](https://python.org) [](https://www.typescriptlang.org/) </div> ## 📖 Project Overview **awesome-oceanbase-mcp** is a Model Context Protocol (MCP) server repository specifically designed for the OceanBase ecosystem. 🎯 **Mission**: Enable AI assistants to interact directly with OceanBase databases and ecosystem components through standardized MCP protocols. ✨ **Core Values**: - 🤖 **AI-Friendly**: Direct database operations within Claude, ChatGPT and other AI assistants - 🔒 **Secure & Reliable**: Provides safe database access and operation mechanisms - 🛠️ **Complete Ecosystem**: Covers the complete OceanBase product and tool chain - 🚀 **Ready to Use**: Simple configuration to get started ## 🔍 What is MCP? The Model Context Protocol (MCP) is an open protocol designed to enable seamless integration between AI applications and external data sources and tools. It provides a standardized way for AI models to access the contextual information and capabilities they need. ## 🚀 Quick Start ### Prerequisites If you don't have an OceanBase database instance yet, please: - Visit [OceanBase Official Repository](https://github.com/oceanbase/oceanbase) to get the latest version - Or use [OceanBase Online Trial](https://www.oceanbase.com/free-trial) for quick setup ## 🗂️ MCP Server Collection This repository provides complete MCP servers for the OceanBase ecosystem: <table> <thead> <tr> <th width="25%">🔧 MCP Server</th> <th width="60%">📝 Description</th> <th width="15%">📚 Documentation</th> </tr> </thead> <tbody> <tr> <td><strong>OceanBase MCP Server</strong></td> <td>Provides secure interaction capabilities with OceanBase databases, supporting SQL queries, data management operations</td> <td><a href="src/oceanbase_mcp_server/README.md">📖 View</a></td> </tr> <tr> <td><strong>OCP MCP Server</strong></td> <td>Integrates with OceanBase Cloud Platform, providing cluster management and monitoring capabilities</td> <td><a href="src/ocp_mcp_server/README.md">📖 View</a></td> </tr> <tr> <td><strong>OBCloud MCP Server</strong></td> <td>Connects to OBCloud services, providing cloud database management functionality</td> <td><a href="src/obcloud_mcp_server/README.md">📖 View</a></td> </tr> <tr> <td><strong>OKCTL MCP Server</strong></td> <td>Manages OceanBase resources and deployments in Kubernetes environments</td> <td><a href="doc/okctl_mcp_server.md">📖 View</a></td> </tr> <tr> <td><strong>OBDIAG MCP Server</strong></td> <td>Provides OceanBase diagnostic tool integration, supporting performance analysis and troubleshooting</td> <td><a href="doc/obdiag_mcp_server.md">📖 View</a></td> </tr> <tr> <td><strong>obshell MCP Server</strong></td> <td>Enables OceanBase cluster creation, deployment and operations management through obshell</td> <td><a href="doc/obshell_mcp_server.md">📖 View</a></td> </tr> </tbody> </table> 💡 **Usage Tips**: Click on the documentation links to view detailed installation and configuration guides. ## 💬 Community & Support We highly value community feedback and contributions! ### 🙋‍♀️ Getting Help - 💬 **Technical Discussion**: Visit [OceanBase Community Forum](https://ask.oceanbase.com) to connect with developers and community partners - 📧 **Technical Support**: Get official technical support through the community forum - 📖 **Documentation Hub**: Check [OceanBase Official Documentation](https://www.oceanbase.com/docs) ### 🐛 Issue Reporting If you encounter any issues during usage: 1. First check the documentation for the corresponding MCP server 2. Search [existing Issues](https://github.com/oceanbase/mcp-oceanbase/issues) to confirm if the issue is known 3. If it's a new issue, please [create a new Issue](https://github.com/oceanbase/mcp-oceanbase/issues/new) ### 🤝 Contributing We welcome all forms of contributions: - 🔧 **Code Contribution**: Submit Pull Requests - 📝 **Documentation**: Improve docs and examples - 🐛 **Bug Reports**: Report bugs and suggest improvements - 💡 **Feature Requests**: Propose new feature requirements ## 📄 License This project is released under the [Apache License 2.0](LICENSE). --- <div align="center"> **⭐ If this project is helpful to you, please give us a Star!** Made with ❤️ by OceanBase Team </div>