Ricursor
Long-term, rotatable project memory and pre-write checks for AI coding agents.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (1)
- LOWin ricursor_workspaces
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"ricursor": {
"url": "https://api.ricursor.com/v1/mcp"
}
}
}Remote-Endpunkte
https://api.ricursor.com/v1/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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).
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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).
Eingabe-Schema
{
"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"
]
}Community
Nachweis