Ricursor

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

Sollte ich dies verwenden

Qualität und Sicherheit

A
Qualität der Beschreibung
92%
Vollständigkeit des Schemas
83%
Qualität der Benennung
80%
Risiko der Vergiftung
100%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Befunde (1)

  • LOWTool 'ricursor_workspaces' description lacks action verbin ricursor_workspaces

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~1,874Tokens (Tool-Definitionen)
~1.4 KBTypische Antwortgröße
Mittlere Auswirkung auf die Aufmerksamkeit (1.46% von 128k Kontext)

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

Was es kann

Tool-Inventar

Tools (12)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟡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

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet12 Tools