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)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| oracle_mcp-0.1.0.tar.gz | 70.4 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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.