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

Related MCP server: Microsoft SQL Server MCP Server

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:

1. Cree un usuario dedicado de OceanBase con permisos mínimos

2. Nunca utilice credenciales root o cuentas administrativas

3. Restringir el acceso a la base de datos únicamente a las operaciones necesarias

4. Habilitar el registro para fines de auditoría

5. 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

1. Bifurcar el repositorio

2. Crea tu rama de funciones ( git checkout -b feature/amazing-feature )

3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )

4. Empujar a la rama ( git push origin feature/amazing-feature )

5. Abrir una solicitud de extracción