Servidor MCP de OceanBase
Un servidor de Protocolo de Contexto de Modelo (MCP) que permite la interacción segura con las bases de datos de OceanBase. Este servidor permite a los asistentes de IA listar tablas, leer datos y ejecutar consultas SQL a través de una interfaz controlada, lo que hace que la exploración y el análisis de bases de datos sean más seguros y estructurados.
Características
- Enumere las tablas OceanBase disponibles como recursos
- Leer el contenido de la tabla
- Ejecutar consultas SQL con manejo de errores adecuado
- Acceso seguro a la base de datos mediante variables de entorno
- Registro completo
Instalación
pip install oceanbase-mcp-server
Configuración
Establezca las siguientes variables de entorno:
OB_HOST=localhost # Database host
OB_PORT=2881 # Optional: Database port (defaults to 2881 if not specified)
OB_USER=your_username
OB_PASSWORD=your_password
OB_DATABASE=your_database
Uso
Con Claude Desktop
Agregue esto a su claude_desktop_config.json :
{
"mcpServers": {
"oceanbase": {
"command": "uv",
"args": [
"--directory",
"path/to/oceanbase_mcp_server",
"run",
"oceanbase_mcp_server"
],
"env": {
"OB_HOST": "localhost",
"OB_PORT": "2881",
"OB_USER": "your_username",
"OB_PASSWORD": "your_password",
"OB_DATABASE": "your_database"
}
}
}
}
Como servidor independiente
# Install dependencies
pip install -r requirements.txt
# Run the server
python -m oceanbase_mcp_server
Desarrollo
# Clone the repository
git clone https://github.com/yourusername/oceanbase_mcp_server.git
cd oceanbase_mcp_server
# Create virtual environment
python -m venv venv
source venv/bin/activate # or `venv\Scripts\activate` on Windows
# Install development dependencies
pip install -r requirements-dev.txt
# Run tests
pytest
Consideraciones de seguridad
- Nunca confirme variables de entorno ni credenciales
- Utilice un usuario de base de datos con los permisos mínimos requeridos
- Considere implementar la lista blanca de consultas para uso en producción
- Supervisar y registrar todas las operaciones de la base de datos
Mejores prácticas de seguridad
Este servidor MCP requiere acceso a la base de datos para funcionar. Por seguridad:
- Cree un usuario dedicado de OceanBase con permisos mínimos
- Nunca utilice credenciales root o cuentas administrativas
- Restringir el acceso a la base de datos únicamente a las operaciones necesarias
- Habilitar el registro para fines de auditoría
- Revisiones de seguridad periódicas del acceso a las bases de datos
Consulte la Guía de configuración de seguridad de OceanBase para obtener instrucciones detalladas sobre:
- Creación de un usuario restringido de OceanBase
- Establecer permisos apropiados
- Monitoreo del acceso a la base de datos
- Mejores prácticas de seguridad
⚠️ IMPORTANTE: Siga siempre el principio del mínimo privilegio al configurar el acceso a la base de datos.
Licencia
Licencia Apache: consulte el archivo LICENCIA para obtener más detalles.
Contribuyendo
- Bifurcar el repositorio
- Crea tu rama de funciones (
git checkout -b feature/amazing-feature ) - Confirme sus cambios (
git commit -m 'Add some amazing feature' ) - Empujar a la rama (
git push origin feature/amazing-feature ) - Abrir una solicitud de extracción