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.2
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.2.tar.gz | 73.7 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| oracle_mcp-0.1.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 95.9 kB
Release files / oracle_mcp-0.1.2.tar.gz
| Download URL | oracle_mcp-0.1.2.tar.gz |
|---|---|
| Size | 73.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1025a56384cc99f6e37da511bbf7d6121571a176cafdfdeed0fdc029a21813e7
|
|
BLAKE2b-256 checksum How to use checksums |
8c18f6f52b1fd7b0dc9bef9f0e35d98f440703d4eb7d53b355f5771e4d2375a2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"CachyOS Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / oracle_mcp-0.1.2-py3-none-any.whl
| Download URL | oracle_mcp-0.1.2-py3-none-any.whl |
|---|---|
| Size | 22.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ce4c5a1860a9993e4f3e53b4752dcd3ed8b0cc731cd03db1d8c7b6f92c47fdfa
|
|
BLAKE2b-256 checksum How to use checksums |
018c850678116a389f5433c3e20c9178d5cb0adb8002b9d57d833823e9f49388
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"CachyOS Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for oracle-mcp 0.1.2
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.
