Ermöglicht es AI-Clients, Ethics Tokens zu validieren, Kontextdimensionen zu kodieren und signierte Value Artifacts über das Value Context Protocol zu verwalten.
Auch bekannt als Creed-Space/vcp-sdk-python, vcp-sdk-python, vcp-sdk
- Stars
- 0
- Tools
- 7
- Downloads, 30 Tage
- 273
- Neueste Version
- 0.8.0
- Letzter Commit
- 6. Nov. 2026
- Lizenz
- Apache-2.0
Was ist vcp MCP?
vcp ist ein MCP server. Ermöglicht es AI-Clients, Ethics Tokens zu validieren, Kontextdimensionen zu kodieren und signierte Value Artifacts über das Value Context Protocol zu verwalten. Er stellt 7 Tools bereit, etwa vcp_status, vcp_validate_token, vcp_parse_csm1.
Zusammenfassung generiert aus dem README des Projekts
Über vcp MCP server
vcp-mcp ermöglicht es, AI Ethics Tokens direkt aus einem AI-Client heraus zu validieren und Kontextdimensionen zu kodieren. Dieser MCP server fungiert als Brücke zum Value Context Protocol und erlaubt es Entwicklern, signierte Value Artifacts zu verwalten und die Einhaltung von Personas durch ein standardisiertes Framework zu verifizieren. Er arbeitet als lokales Computation Tool über stdio oder via eines stateless HTTP Transports, wodurch sichergestellt wird, dass während der Verarbeitung keine Nutzerdaten gelesen werden und keine Netzwerkaufrufe getätigt werden.
Nutzer können mit dem Server Tools wie vcp_validate_token zum Parsen von VCP/I Tokens, vcp_encode_context zur Transformation von achtzehn verschiedenen Kontextdimensionen in Wire Formats und creed_classify_principle zum Mapping von Prinzipien auf Schwartz-Werte nutzen. Der Server ist für die Integration mit Clients wie Claude Desktop oder Claude Code ausgelegt. Für die lokale Nutzung ist keine Authentifizierung erforderlich, bei Remote-HTTP-Deployments sollte jedoch ein Gateway oder Reverse Proxy vorgeschaltet werden, da der Server selbst unauthentifiziert ist.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du vcp MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenvcp MCP in Claude Code installieren
$ claude mcp add vcp-sdk-python -- uvx vcp-sdkvcp MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"vcp-sdk-python": {
"command": "uvx",
"args": [
"vcp-sdk"
]
}
}
}vcp MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"vcp-sdk-python": {
"type": "stdio",
"command": "uvx",
"args": [
"vcp-sdk"
]
}
}
}vcp MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"vcp-sdk-python","type":"stdio","command":"uvx","args":["vcp-sdk"]}'vcp MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"vcp-sdk-python": {
"command": "uvx",
"args": [
"vcp-sdk"
]
}
}
}vcp MCP in Codex installieren
$ codex mcp add vcp-sdk-python -- uvx vcp-sdkvcp MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.vcp-sdk-python] command = "uvx" args = ["vcp-sdk"]
vcp MCP in Gemini CLI installieren
$ gemini mcp add -s user vcp-sdk-python uvx -- vcp-sdkvcp MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"vcp-sdk-python": {
"command": "uvx",
"args": [
"vcp-sdk"
]
}
}
}vcp MCP tools 7
Erkannt aus dem READMEvcp_statusvcp_validate_tokenvcp_parse_csm1vcp_encode_contextvcp_validate_litevcp_lite_to_csm1creed_classify_principle
| vcp_status | — | |
| vcp_validate_token | — | |
| vcp_parse_csm1 | — | |
| vcp_encode_context | — | |
| vcp_validate_lite | — | |
| vcp_lite_to_csm1 | — | |
| creed_classify_principle | — |
Konfiguration
VCP_MCP_ALLOW_INSECURE_HTTP
| Name | Beschreibung | Typ |
|---|---|---|
| VCP_MCP_ALLOW_INSECURE_HTTP | — |
Automatisierte Checks
Geluften am 13. 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 erreichbarBestanden
- Open Source Lizenz (OSI)Bestanden
- Commit oder Release im letzten JahrBestanden
- Package-Name ähnelt keinem populären PackageBestanden
- Remote Endpoint nutzt HTTPSNicht geprüft
- Destruktive Tools sind markiertBestanden
- Keine versteckten Anweisungen an das ModellBestanden
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenBestanden
README
Auf GitHub ansehenvcp-sdk
Python SDK for the Value Context Protocol (VCP) — portable AI ethics
validation — plus the Creed Commons client (vcp CLI) for installing
signed value artifacts.
- Protocol and docs: valuecontextprotocol.org
- Creed Commons registry: Creed-Space/vcp-hub
Legacy distribution status
This repository supplies the legacy standalone vcp-sdk 0.9.0 distribution on
PyPI and the
io.github.Creed-Space/vcp-mcp 0.9.0 server entry in the MCP Registry. It is
separate from, and is not, the project-maintained VCP-SDK. To review and run
this source directly, select and verify an exact commit, then install that
checkout:
git checkout --detach <reviewed-vcp-sdk-python-commit>
python -m pip install .
python -m pip install ".[hub]" # include the Creed Commons CLI dependencies
This candidate and the project-maintained VCP-SDK both use the vcp Python
import namespace. Install them in separate virtual environments. Installing
both into one environment is unsupported because one distribution can replace
the other's modules.
SDK — tokens, CSM1, VCP-Lite
from vcp import Token, CSM1Code, validate_lite
token = Token.parse("family.safe.guide@1.0.0")
code = CSM1Code.parse("N5+F+E")
identity = {"domain": "family", "approach": "safe", "role": "guide"}
document = {"vcp_version": "lite-1.0", "identity": identity, "persona": "nanny", "adherence": 5, "scopes": ["F"]}
errors = validate_lite(document)
CSM1Code.encode() (and str(code)) emits the canonical form with scopes
sorted (N5+F+E encodes as N5+E+F), matching the project-maintained
VCP-SDK and spec §2.10.1; to_nano()/to_micro() preserve input order.
Token.parse also accepts creed:// and vcp:// URIs and normalises them to
canonical form — a superset of the reference SDK, whose parse takes only
the bare token grammar.
Creed Commons — signed value artifacts
Creed Commons distributes constitutions, creeds, and detector configs as signed data that a values engine interprets — never executable code. Installing an artifact is a signature-verification decision, not a code-execution one:
vcp search gaslighting
vcp install creed-space/anti_gaslighting # verify Ed25519 + sha256 + schema, then write
vcp verify # re-check installed tree against vcp.lock
vcp install verifies against a trust root pinned inside this package
(the registry cannot vouch for itself), pins name@version + content sha256 +
the verifying key in vcp.lock, and never imports, evals, or executes what it
fetched.
Community namespaces are delegated, never a new root: the hub's
namespace_registry.json binds each namespace to its publisher's Ed25519 keys
and is itself signed by the pinned root; artifacts must verify against a key
registered to their own namespace. Registration and moderation:
GOVERNANCE.md.
Trust tiers: signed proves integrity and origin, not semantics; verified
additionally carries a domain-separated root counter-signature (issued
after lint + red-team + human review) that the client checks on install and
on every vcp verify.
CLI — protocol operations
Alongside the Creed Commons commands, vcp runs the protocol operations
directly. These call the same functions the MCP tools do, so scripted CLI
output and MCP tool output carry the same fields.
vcp token validate family.safe.guide@1.0.0 # parse a VCP/I token
vcp token parse N5+F+E # parse a CSM1 code
vcp lite validate agent.json # validate a VCP-Lite document
vcp lite to-csm1 agent.json # VCP-Lite document -> CSM1 code
vcp encode --space office --agency peer # context -> VCP/A wire format
vcp classify "Never endanger a child" # principle -> Schwartz value
vcp status # versions, capabilities, vocabularies
Output is JSON by default. --quiet prints just the value the command is
about, for shell consumption:
$ vcp lite to-csm1 agent.json --quiet
N5+E+F
$ vcp encode --space office --constraints legal --constraints time --quiet
📍🏢|🔒⚖️⏱️
The validate/parse commands exit 0 when valid and 1 when invalid, so
they work as a CI gate:
vcp lite validate agent.json --quiet || exit 1
vcp encode takes one flag per context dimension (--space, --agency,
--cognitive-state, …); --company and --constraints repeat for multiple
values, and each personal dimension has a matching --<dim>-intensity (1-5).
Run vcp encode --help for the full list.
MCP Server
vcp-mcp exposes the SDK to any MCP client (Claude Code, Claude Desktop, or
anything else that speaks the protocol). It runs over stdio by default and is
pure local computation — no network calls, no state between calls, no user
data read.
python -m pip install ".[mcp]"
vcp-mcp
Claude Desktop / Claude Code config:
{
"mcpServers": {
"vcp": {
"command": "vcp-mcp"
}
}
}
Tools
| Tool | What it does |
|---|---|
vcp_status |
SDK/spec versions, capabilities, dimension and persona vocabularies |
vcp_validate_token |
Parse a VCP/I token into domain / approach / role / version / namespace |
vcp_parse_csm1 |
Parse a CSM1 code into persona / adherence / scopes / namespace / version (conflicting or deprecated scopes are rejected) |
vcp_encode_context |
Encode the 18 VCP/A context dimensions to wire, JSON, and session metadata |
vcp_validate_lite |
Validate a VCP-Lite document; returns the equivalent CSM1 code and token |
vcp_lite_to_csm1 |
Convert VCP-Lite persona/adherence/scopes to a CSM1 code |
creed_classify_principle |
Map a constitution principle to a Schwartz value; flag circular-model tensions |
Resource vcp://lite/examples serves the bundled VCP-Lite example documents.
HTTP transport
For hosted deployments, vcp-mcp also speaks Streamable HTTP:
vcp-mcp --transport http --port 8080 # binds 127.0.0.1, endpoint /mcp
--port defaults to $PORT then 8080. The endpoint runs stateless (a
fresh transport per request), so a gateway may route any request to any
replica. Only POST /mcp is served — GET would otherwise hold an idle event
stream open per connection, so it is refused with a clean JSON-RPC 405. A
GET /health endpoint returns {"status": "ok"}.
The server has no authentication, so binding beyond loopback requires an explicit opt-in:
VCP_MCP_ALLOW_INSECURE_HTTP=true vcp-mcp --transport http --host 0.0.0.0
Set that only when either a gateway or reverse proxy fronts the server and
handles client auth, or you intentionally run it as a public, unauthenticated,
stateless compute endpoint (as render.yaml in this repo does). In the latter
case put a rate limit / WAF in front of it: the exposure is abuse of paid
compute rather than data, since the server holds no state and reads nothing.
Development
pip install -e ".[dev]"
pytest tests/
License
Apache-2.0. © Creed Space.
vcp MCP Fragen
Wie füge ich vcp MCP zu Claude Code hinzu?
Führe claude mcp add vcp-sdk-python -- uvx vcp-sdk in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich vcp MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet vcp MCP?
Er stellt 7 Tools bereit, darunter vcp_status, vcp_validate_token, vcp_parse_csm1, vcp_encode_context, vcp_validate_lite.
Benötigt der Server eine Internetverbindung, um zu funktionieren?
Nein, der Server führt reine lokale Berechnungen ohne Netzwerkaufrufe durch, speichert keinen Status zwischen den Aufrufen und liest keine Nutzerdaten aus.
Ist der Creed Commons Datensatz ausführbarer Code?
Nein, Creed Commons verteilt signierte Daten, die von einer Values Engine interpretiert werden, wodurch sichergestellt wird, dass es niemals ausführbarer Code ist.
Erfordert der HTTP Transport Mode eine Authentifizierung?
Standardmäßig hat der Server keine Authentifizierung; wenn du ihn über den Loopback hinaus bindest, musst du ein Gateway oder einen Reverse Proxy verwenden, um die Client-Authentifizierung zu handhaben.