Verwaltet portable, datenschutzgefilterte menschliche Präferenzen und Kontexte für KI-Tools mithilfe lokaler Markdown-Profile.
Auch bekannt als markoblogo/ID, id, id-protocol
- Stars
- 1
- Tools
- —
- Downloads, 30 Tage
- 451
- Neueste Version
- 0.4.0
- Letzter Commit
- 23. Okt. 2026
- Lizenz
- MIT
Was ist ID Protocol MCP?
Verwaltet portable, datenschutzgefilterte menschliche Präferenzen und Kontexte für KI-Tools mithilfe lokaler Markdown-Profile.
Zusammenfassung generiert aus dem README des Projekts
Über ID Protocol MCP server
ID Protocol bietet Entwicklern eine Möglichkeit, persönliche Präferenzen und Kontexte für KI-Tools mithilfe lokaler Markdown-Dateien zu verwalten. Anstatt sich auf herstellerspezifische Einstellungen zu verlassen, pflegen Nutzer ihre eigene Single Source of Truth über Dateien wie profile.minimal.md und profile.core.md. Dieses System ermöglicht es dir, datenschutzgefilterte, kompakte Kontexte zu erstellen, die zwischen verschiedenen KI-Agenten und Repositories verschoben werden können, ohne sensible Daten auf einen zentralen Server hochzuladen.
Das Tool arbeitet als lokales CLI und erfordert Python 3.11 oder neuer. Du nutzt den idctl Befehl, um Profile zu initialisieren, zu validieren und spezifische Ansichten wie soul.md oder context.compact.json zu exportieren. Es verwendet ein Privacy-Policy-System, um sicherzustellen, dass nur freigegebene Felder in die Exports aufgenommen werden, indem alle Daten blockiert werden, die nicht der angegebenen owner_id entsprechen. Dieses Setup ist für Nutzer gedacht, die genau kontrollieren wollen, welche Informationen ein KI-Client während einer Session erhält.
Was du damit machen kannst
- 1Datenschutzgefilterten KI-Kontext generierenErstelle eine kompakte JSON-Datei, die nur die spezifischen Nutzerpräferenzen enthält, die du für den Export freigegeben hast.
- 2Lokale Präferenzdateien pflegenVerwalte deine Arbeitsbeschränkungen und menschlichen Präferenzen mithilfe lokaler Markdown-Dateien, die du selbst besitzt und kontrollierst.
- 3Profiländerungen über die Zeit auditierenVergleiche dein aktuelles Profil mit dem Stand von vor einer Woche, um zu sehen, was sich geändert hat.
- 4Bootstrap-Daten für Agenten vorbereitenErzeuge eine kurze Bootstrap-Datei, um einem KI-Agenten sofortigen Kontext bereitzustellen.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du ID Protocol MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenID Protocol MCP in Claude Code installieren
$ claude mcp add id -- uvx id-protocolID Protocol MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"id": {
"command": "uvx",
"args": [
"id-protocol"
]
}
}
}ID Protocol MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"id": {
"type": "stdio",
"command": "uvx",
"args": [
"id-protocol"
]
}
}
}ID Protocol MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"id","type":"stdio","command":"uvx","args":["id-protocol"]}'ID Protocol MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"id": {
"command": "uvx",
"args": [
"id-protocol"
]
}
}
}ID Protocol MCP in Codex installieren
$ codex mcp add id -- uvx id-protocolID Protocol MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.id] command = "uvx" args = ["id-protocol"]
ID Protocol MCP in Gemini CLI installieren
$ gemini mcp add -s user id uvx -- id-protocolID Protocol MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"id": {
"command": "uvx",
"args": [
"id-protocol"
]
}
}
}Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarmarkoblogo/id is public and reachablegithub.com/markoblogo/id ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Sigstore attestation for id-protocolpypi.org/project/id-protocol/ ↗Bestanden
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-10-23github.com/markoblogo/id ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from id-protocolBestanden
- Keine kritischen Advisories im Paket oder seinen Abhängigkeiten1 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenID Protocol — portable context for AI tools
Keep your working preferences in files you control. ID turns a reviewed profile into compact, privacy-filtered context that can move between AI tools and repositories.
Try it in five minutes
Requires Python 3.11 or newer.
uv tool install id-protocol
mkdir my-id-profile && cd my-id-profile
idctl init --owner-id demo
Edit profiles/demo/profile.minimal.md, then build and inspect the portable output:
idctl validate --owner-id demo
idctl refresh-soul --owner-id demo
idctl export-compact --owner-id demo
idctl diff --owner-id demo --since 7d
The starter profile is provisional until you review it. Use an alias such as demo or my-work-profile; a legal name is unnecessary. ID does not upload generated files.
Files and ownership
| File | Role |
|---|---|
profile.minimal.md |
Small owner-edited starting profile |
profile.core.md |
Canonical profile when a fuller source is needed |
profile.extended.md |
Optional detailed workflows and context |
privacy-policy.v1.json |
Per-field export permissions |
handshake.md |
Concise rules for applying context |
soul.md |
Short derived bootstrap for an agent |
context.compact.json |
Privacy-filtered portable context |
mcp.context.resource.json |
Resource payload for an external MCP adapter |
Markdown profiles remain the source of truth. Generated JSON is a transport view and may omit nuance. The package is a local CLI; it does not provide an MCP server or synchronize vendor accounts.
Privacy behavior
Compact and MCP resource exports require a valid policy whose owner_id matches the requested profile. Unlisted fields stay local-only. Missing, malformed, mixed, conflicting, or owner-mismatched policies block export.
Legacy list policies from earlier releases are normalized in memory during validation and export. Their source files remain unchanged and their restrictions remain effective. --allow-unfiltered only permits a missing policy in a reviewed legacy workflow; it cannot bypass an invalid policy.
Review the resulting export before attaching it to another tool. See the privacy model, policy schema, and threat model.
ABVX toolchain
| Product | Responsibility | Tested release |
|---|---|---|
| ID | Human preferences and operating constraints | 0.5.2 |
| agentsgen | Repository instructions and commands | 0.5.0 |
| SET | Review-first workflow planning and exports | 0.4.0 |
| abvx-agent-skills | Optional reusable workflows | 0.15.0 |
These remain independently installable. ID does not install companions or grant tool permissions.
For a repository that already contains a reviewed ID profile:
idctl install-set-hook --path .
The adapter returns owner-local bootstrap pointers to SET and preserves an existing custom hook. See the SET integration guide.
Evidence
Three reproducible demos exercise installed onboarding, policy-filtered omission, legacy-policy compatibility, and the agentsgen/SET handoff with synthetic data. They measure local CLI behavior and runtime, not AI answer quality.
The historical benchmark snapshot is a small checked-in sample with explicit limits. AI-client behavior still depends on each client's configuration and context rules.
Develop
git clone https://github.com/markoblogo/ID.git
cd ID
python -m venv .venv
. .venv/bin/activate
python -m pip install ".[dev]" build twine
make validate
make drift-check
make coverage
make release-build
make release-check
Start with the documentation index, protocol, integration boundaries, and contributing guide. Use synthetic profiles in public issues and pull requests.
ABVX ecosystem
- AGENTS.md_generator — Exports reviewed context for repository guidance. Current release:
v0.5.1. - AGENTS.md_generator — Keeps repository guidance and machine-readable context current. Current release:
v0.5.1. - abvx-agent-skills — Uses shared, reviewable agent capabilities during maintenance. Current release:
v0.16.1.
This block is generated from the reviewed ABVX ecosystem registry.
ID Protocol MCP Fragen
Wie füge ich ID Protocol MCP zu Claude Code hinzu?
Führe claude mcp add id -- uvx id-protocol in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich ID Protocol MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Lädt ID Protocol meine Daten auf einen Server hoch?
Nein, das Tool ist ein lokales CLI und lädt keine generierten Dateien hoch.
Wie funktioniert die Filterung des Datenschutzes?
Exports erfordern eine gültige Policy, bei der die owner ID mit dem Profil übereinstimmt; nicht gelistete Felder bleiben rein lokal.
Welche Systemanforderungen gibt es für ID Protocol?
Du benötigst eine installierte Version von Python 3.11 oder neuer.