Skip to main content

oracle-mcp

Servidor MCP (Model Context Protocol) oficial para consultar, evaluar y falsar medidas de un proyecto Oracle sin modificar el sistema de archivos.

Sólo lectura

oracle-mcp es estrictamente de sólo lectura respecto del proyecto fijado al inicio. Un agente no puede crear, modificar ni borrar archivos del proyecto, ni alterar las reglas o evidencias para darse la razón a sí mismo. La autoridad y el alcance quedan determinados en el arranque y ninguna llamada puede ampliarlos.

Instalación

Instalá oracle-mcp como herramienta global con uv:

uv tool install oracle-mcp

O agregalo a un entorno virtual de desarrollo:

uv pip install oracle-mcp

Configuración en clientes MCP

El servidor se comunica a través de stdio. Al iniciarlo se especifica la raíz del proyecto a inspeccionar mediante --proyecto <ruta>.

Claude Code

Configurá el servidor en tu archivo de configuración de Claude Code (por ejemplo en ~/.claude/claude.json o a nivel de proyecto):

{
  "mcpServers": {
    "oracle": {
      "command": "oracle-mcp",
      "args": ["--proyecto", "."]
    }
  }
}

O agregalo mediante el CLI:

claude mcp add oracle oracle-mcp -- --proyecto .

Codex

En la configuración de MCP de Codex:

{
  "mcpServers": {
    "oracle": {
      "command": "oracle-mcp",
      "args": ["--proyecto", "."]
    }
  }
}

Herramientas disponibles

El servidor expone exactamente cinco herramientas de sólo lectura:

Herramienta Qué hace
oracle_effective_catalog Consulta las medidas efectivas del proyecto fijado según su jurisdicción y ámbito. Sin ids devuelve el índice compacto; con ids devuelve el detalle normativo completo con umbrales, alcance y estado de fijación.
oracle_evaluate Evalúa una medida por identificador efectivo o por texto en memoria contra evidencia JSON. Distingue tres estados (verde, rojo, sin_evidencia) e informa valor, umbral, testigos y estado de sombra con cotas y perdón.
oracle_challenge Desafía una medida por id o texto contra casos de corpus y efímeros. Exige ambas polaridades y corre mutantes algebraicos para reportar discordancias y sobrevivientes sin tocar el disco.
oracle_judge Juzga evidencia JSON contra el catálogo efectivo del proyecto (o un subconjunto de ids). Evalúa cumplimiento de reglas, aplica sombras con cotas e informa medidas no aplicadas.
oracle_tasks Lee el tracker de tareas (tareas/) del proyecto para agentes sin acceso a terminal: listar tareas abiertas o cerradas por estado o etiqueta, ver detalle y notas de una tarea por id o prefijo, buscar texto o extraer hechos relacionales.

Contrato

Para consultar los esquemas JSON de entrada y salida, la especificación de errores tipados, el cálculo determinista de huellas criptográficas y las garantías de concurrencia y transporte, revisá el Contrato MCP.

Metadata

Release files for oracle-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for oracle-mcp 0.1.0
File Size Uploaded Provenance
oracle_mcp-0.1.0.tar.gz 70.4 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for oracle-mcp 0.1.0
File Interpreter ABI Platform
oracle_mcp-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 91.7 kB

Release files / oracle_mcp-0.1.0.tar.gz

Download URL oracle_mcp-0.1.0.tar.gz
Size 70.4 kB
Tags Source
SHA-256 checksum
How to use checksums
1cb1233627a877fcc8f5c9e111efad5a227d2378f78f33f990b7035c2b1d3f96
BLAKE2b-256 checksum
How to use checksums
e600f0688270c672d437296c3e409ac140e892e21cecb7dc351ece85dfdb665e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.15

Release files / oracle_mcp-0.1.0-py3-none-any.whl

Download URL oracle_mcp-0.1.0-py3-none-any.whl
Size 21.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a3c16a3cb4ef80c2140f48014b12b6c5d1043c6f5a0883f57a8a8c9c74893b9e
BLAKE2b-256 checksum
How to use checksums
d5c7f756cac4e19f8a765f2ca08aa85d8d0495d951984f8ba7fbc21b03d5d19b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.15

Security for oracle-mcp 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page