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
Desde la raíz del proyecto:
claude mcp add oracle -- oracle-mcp --proyecto .
Codex
En ~/.codex/config.toml:
[mcp_servers.oracle]
command = "oracle-mcp"
args = ["--proyecto", "/ruta/al/proyecto"]
Herramientas disponibles
El servidor expone exactamente seis 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. |
oracle_requirements |
La cobertura de requisitos/*.requisito (Oracle 0.35.0): qué promesas mide alguna medida, cuáles en parte y cuáles no, las medidas que un requisito nombra sin que existan y las medidas que no cubren ninguno. |
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.
1 maintainer
Metadata
1 maintainer
Release files for oracle-mcp 0.1.1
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.1.tar.gz | 72.9 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| oracle_mcp-0.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 95.1 kB
Release files / oracle_mcp-0.1.1.tar.gz
| Download URL | oracle_mcp-0.1.1.tar.gz |
|---|---|
| Size | 72.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f1244dce1f8ffb570550064b67b57b6d638f330fd196e2a27831418e23264d2a
|
|
BLAKE2b-256 checksum How to use checksums |
a27e9791044d9ed556d775da81420249e1461afa9402c25b09c93fa4ec38d63f
|
| 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.1-py3-none-any.whl
| Download URL | oracle_mcp-0.1.1-py3-none-any.whl |
|---|---|
| Size | 22.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b9693c04395160854e3c538ef9c68d227b093789e668d1d7d26e346506d5406e
|
|
BLAKE2b-256 checksum How to use checksums |
354104c933331d93d3341d65570cb54c9be8844bd0dffdfb30615603b80b3ceb
|
| 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.1
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.
