Ricursor

Long-term, rotatable project memory and pre-write checks for AI coding agents.

¿Debería usar esto?

Calidad y seguridad

A
Calidad de la descripción
92%
Integridad del esquema
83%
Calidad de los nombres
80%
Riesgo de envenenamiento
100%
Coincidencia de permisos
100%
Cumplimiento del protocolo
100%

Hallazgos (1)

  • LOWTool 'ricursor_workspaces' description lacks action verben ricursor_workspaces

Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.

Costo de contexto

~1,874Tokens (definiciones de herramientas)
~1.4 KBTamaño de respuesta típico
Impacto moderado en la atención (1.46% del contexto de 128k)

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-http

Qué puede hacer

Inventario de herramientas

Herramientas (12)

🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟡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

Califica este servidor

Evidencia

Observaciones recientes

verificadoversión no registrada12 herramientas