Ricursor
Long-term, rotatable project memory and pre-write checks for AI coding agents.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (1)
- LOWen ricursor_workspaces
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"ricursor": {
"url": "https://api.ricursor.com/v1/mcp"
}
}
}Puntos de conexión remotos
https://api.ricursor.com/v1/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (12)
🟡ricursor_action_check(kind, project, action_id, path, baseline_hash, ...)
Metadata-only decision for a JS/TS write or delete. Returns allow or block (with reasons to fix) plus a one-use receipt. Never send source.
Esquema de entrada
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"write",
"delete"
]
},
"project": {
"type": "string"
},
"action_id": {
"type": "string",
"description": "Unique per proposed action, 8-80 characters."
},
"path": {
"type": "string"
},
"baseline_hash": {
"anyOf": [
{
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
{
"type": "null"
}
]
},
"result_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"expected_version": {
"type": "integer",
"minimum": 0
},
"metadata": {
"type": "object"
},
"dependencies": {
"type": "array"
}
},
"required": [
"kind",
"project",
"action_id",
"path",
"baseline_hash"
]
}⚪ricursor_action_consume(action_id, receipt, baseline_hash, result_hash)
Atomically consumes a receipt immediately before the broker executes. Fails if anything changed.
Esquema de entrada
{
"type": "object",
"properties": {
"action_id": {
"type": "string",
"description": "Unique per proposed action, 8-80 characters."
},
"receipt": {
"type": "string"
},
"baseline_hash": {
"anyOf": [
{
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
{
"type": "null"
}
]
},
"result_hash": {
"anyOf": [
{
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
{
"type": "null"
}
]
}
},
"required": [
"action_id",
"receipt",
"baseline_hash",
"result_hash"
],
"additionalProperties": false
}🟢ricursor_action_group_check(project, group_id, actions)
Metadata-only decision for up to 20 related JS/TS writes/deletes judged on their combined end state (moves, renames).
Esquema de entrada
{
"type": "object",
"properties": {
"project": {
"type": "string"
},
"group_id": {
"type": "string",
"description": "Unique per proposed action, 8-80 characters."
},
"actions": {
"type": "array",
"minItems": 1,
"maxItems": 20,
"items": {
"type": "object"
}
}
},
"required": [
"project",
"group_id",
"actions"
]
}⚪ricursor_action_group_consume(group_id, receipt)
All-or-nothing consumption before the broker writes the group.
Esquema de entrada
{
"type": "object",
"properties": {
"group_id": {
"type": "string",
"description": "Unique per proposed action, 8-80 characters."
},
"receipt": {
"type": "string"
}
},
"required": [
"group_id",
"receipt"
],
"additionalProperties": false
}🟡ricursor_correct(project, action_id, rule)
After Ricursor blocks a check, save the one-sentence lesson so every agent on this project gets it. Only accepted for your own blocked action from the last 24 hours.
Esquema de entrada
{
"type": "object",
"properties": {
"project": {
"type": "string",
"description": "Project name inside the workspace."
},
"action_id": {
"type": "string",
"description": "action_id or group_id of the blocked check."
},
"rule": {
"type": "string",
"minLength": 8,
"maxLength": 500
}
},
"required": [
"project",
"action_id",
"rule"
],
"additionalProperties": false
}🟢ricursor_ledger(project)
Read scoped metadata and rule versions before switching models. Observe only.
Esquema de entrada
{
"type": "object",
"properties": {
"project": {
"type": "string",
"description": "Project name inside the workspace."
}
},
"required": [
"project"
],
"additionalProperties": false
}🟡ricursor_handoff(project, task_id, expected_version, state)
Save structured task IDs and versioned rule decisions; never include prompts or source.
Esquema de entrada
{
"type": "object",
"properties": {
"project": {
"type": "string",
"description": "Project name inside the workspace."
},
"task_id": {
"type": "string"
},
"expected_version": {
"type": "integer",
"minimum": 0
},
"state": {
"type": "object",
"additionalProperties": false,
"required": [
"completed",
"pending",
"decisions"
],
"properties": {
"completed": {
"type": "array",
"items": {
"type": "string"
}
},
"pending": {
"type": "array",
"items": {
"type": "string"
}
},
"decisions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"constraint_id",
"version",
"status"
],
"properties": {
"constraint_id": {
"type": "string"
},
"version": {
"type": "integer",
"minimum": 1
},
"status": {
"type": "string",
"enum": [
"accepted",
"conflict"
]
}
}
}
}
}
}
},
"required": [
"project",
"task_id",
"expected_version",
"state"
],
"additionalProperties": false
}⚪ricursor_snapshot(project, files)
Sync locally extracted JS/TS structural metadata only; never transmit source.
Esquema de entrada
{
"type": "object",
"properties": {
"project": {
"type": "string",
"description": "Project name inside the workspace."
},
"files": {
"type": "array",
"minItems": 1,
"maxItems": 20,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"path",
"hash",
"metadata",
"expected_version"
],
"properties": {
"path": {
"type": "string"
},
"hash": {
"anyOf": [
{
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
{
"type": "null"
}
]
},
"metadata": {
"anyOf": [
{
"type": "object",
"additionalProperties": false,
"required": [
"exports",
"imports"
],
"properties": {
"exports": {
"type": "array",
"items": {
"type": "string"
}
},
"imports": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"source",
"names"
],
"properties": {
"source": {
"type": "string"
},
"names": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}
},
{
"type": "null"
}
]
},
"expected_version": {
"type": "integer",
"minimum": 0
}
}
}
}
},
"required": [
"project",
"files"
],
"additionalProperties": false
}🟢ricursor_check(project, path, hash, metadata, expected_version, ...)
Stop on block or errors. Checks tracked versions, exports and accepted import boundaries; never writes code.
Esquema de entrada
{
"type": "object",
"properties": {
"project": {
"type": "string",
"description": "Project name inside the workspace."
},
"path": {
"type": "string"
},
"hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"metadata": {
"type": "object",
"additionalProperties": false,
"required": [
"exports",
"imports"
],
"properties": {
"exports": {
"type": "array",
"items": {
"type": "string"
}
},
"imports": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"source",
"names"
],
"properties": {
"source": {
"type": "string"
},
"names": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}
},
"expected_version": {
"type": "integer",
"minimum": 0
},
"dependencies": {
"type": "array",
"maxItems": 100,
"items": {
"type": "object",
"required": [
"path",
"version"
],
"properties": {
"path": {
"type": "string"
},
"version": {
"type": "integer",
"minimum": 1
}
}
}
}
},
"required": [
"project",
"path",
"hash",
"metadata",
"expected_version",
"dependencies"
],
"additionalProperties": false
}🟢ricursor_workspaces
The workspace this key can reach.
Esquema de entrada
{
"type": "object",
"properties": {}
}🟢ricursor_context(workspace, project, limit, task, since)
The verified corrections and recent file changes an agent must respect before it writes code.
Esquema de entrada
{
"type": "object",
"properties": {
"workspace": {
"type": "string",
"description": "Ignored: the key already selects its workspace."
},
"project": {
"type": "string",
"description": "Project name inside the workspace."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20
},
"task": {
"type": "string",
"description": "Task to retrieve relevant rules for."
},
"since": {
"type": "string",
"description": "Previous cursor for this same key, project and task; returns changed rules and removed IDs."
}
}
}⚪ricursor_report(workspace, project, request_id, usage, state)
Record what an agent spent (usage) and what it changed (state).
Esquema de entrada
{
"type": "object",
"properties": {
"workspace": {
"type": "string",
"description": "Ignored: the key already selects its workspace."
},
"project": {
"type": "string",
"description": "Project name inside the workspace."
},
"request_id": {
"type": "string",
"description": "Unique ID per logical report; reuse unchanged when retrying."
},
"usage": {
"type": "object",
"required": [
"model",
"day",
"baseline_tokens",
"served_tokens"
],
"properties": {
"model": {
"type": "string"
},
"day": {
"type": "string",
"description": "YYYY-MM-DD"
},
"baseline_tokens": {
"type": "integer"
},
"served_tokens": {
"type": "integer"
}
}
},
"state": {
"type": "object",
"required": [
"kind",
"path",
"detail"
],
"properties": {
"kind": {
"type": "string",
"enum": [
"file_change",
"delta",
"alert"
]
},
"path": {
"type": "string"
},
"detail": {
"type": "string",
"enum": [
"file_added",
"file_updated",
"file_deleted",
"exports_changed",
"imports_changed",
"stale_baseline",
"policy_conflict"
]
}
}
}
},
"required": [
"request_id"
]
}Comunidad
Evidencia