Memungkinkan AI client untuk memvalidasi ethics token, melakukan encoding pada dimensi konteks, dan mengelola signed value artifacts menggunakan Value Context Protocol.
Juga dikenal sebagai Creed-Space/vcp-sdk-python, vcp-sdk-python, vcp-sdk
- Stars
- 0
- Tools
- 7
- Unduhan, 30 hari
- 273
- Versi terbaru
- 0.8.0
- Commit terakhir
- 6 Nov 2026
- Lisensi
- Apache-2.0
Apa itu vcp MCP?
vcp adalah MCP server. Memungkinkan AI client untuk memvalidasi ethics token, melakukan encoding pada dimensi konteks, dan mengelola signed value artifacts menggunakan Value Context Protocol. Server ini menyediakan 7 tool, seperti vcp_status, vcp_validate_token, vcp_parse_csm1.
Ringkasan dibuat dari README proyek
Tentang vcp MCP server
vcp-mcp memungkinkan validasi AI ethics token dan encoding dimensi konteks langsung dari dalam AI client. Server ini menyediakan jembatan ke Value Context Protocol, yang memungkinkan developer untuk mengelola signed value artifacts dan memverifikasi kepatuhan persona melalui framework yang terstandarisasi. Server ini berfungsi sebagai tool komputasi lokal yang berjalan melalui stdio atau via stateless HTTP transport, memastikan tidak ada data pengguna yang dibaca dan tidak ada panggilan jaringan yang dilakukan selama pemrosesan.
User dapat berinteraksi dengan server menggunakan tool seperti vcp_validate_token untuk memparsing token VCP/I, vcp_encode_context untuk mentransformasi delapan belas dimensi konteks yang berbeda ke dalam wire formats, dan creed_classify_principle untuk memetakan prinsip ke Schwartz values. Server ini dirancang untuk integrasi dengan client seperti Claude Desktop atau Claude Code. Tidak diperlukan autentikasi untuk penggunaan lokal, meskipun deployment HTTP jarak jauh harus dilindungi oleh gateway atau reverse proxy karena server itu sendiri tidak memiliki autentikasi.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal vcp MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal vcp MCP di Claude Code
$ claude mcp add vcp-sdk-python -- uvx vcp-sdkInstal vcp MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"vcp-sdk-python": {
"command": "uvx",
"args": [
"vcp-sdk"
]
}
}
}Instal vcp MCP di VS Code
.vscode/mcp.json
{
"servers": {
"vcp-sdk-python": {
"type": "stdio",
"command": "uvx",
"args": [
"vcp-sdk"
]
}
}
}Instal vcp MCP di VS Code CLI
$ code --add-mcp '{"name":"vcp-sdk-python","type":"stdio","command":"uvx","args":["vcp-sdk"]}'Instal vcp MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"vcp-sdk-python": {
"command": "uvx",
"args": [
"vcp-sdk"
]
}
}
}Instal vcp MCP di Codex
$ codex mcp add vcp-sdk-python -- uvx vcp-sdkInstal vcp MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.vcp-sdk-python] command = "uvx" args = ["vcp-sdk"]
Instal vcp MCP di Gemini CLI
$ gemini mcp add -s user vcp-sdk-python uvx -- vcp-sdkInstal vcp MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"vcp-sdk-python": {
"command": "uvx",
"args": [
"vcp-sdk"
]
}
}
}Tool vcp MCP 7
Terdeteksi dari 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 | — |
Konfigurasi
VCP_MCP_ALLOW_INSECURE_HTTP
| Nama | Deskripsi | Tipe |
|---|---|---|
| VCP_MCP_ALLOW_INSECURE_HTTP | — |
Pengecekan otomatis
Berjalan 13 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkauLolos
- Lisensi open source (OSI)Lolos
- Ada commit atau release dalam satu tahun terakhirLolos
- Nama package tidak mirip dengan package populerLolos
- Remote endpoint menggunakan HTTPSTidak diperiksa
- Tools yang bersifat destruktif telah diberi labelLolos
- Tidak ada instruksi tersembunyi untuk modelLolos
- Tidak ada advisory kritis pada paket atau dependensinyaLolos
README
Lihat di GitHubvcp-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.
Pertanyaan tentang vcp MCP
Bagaimana cara menambahkan vcp MCP ke Claude Code?
Jalankan claude mcp add vcp-sdk-python -- uvx vcp-sdk di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan vcp MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Tool apa yang disediakan vcp MCP?
Server ini menyediakan 7 tool, termasuk vcp_status, vcp_validate_token, vcp_parse_csm1, vcp_encode_context, vcp_validate_lite.
Apakah server memerlukan koneksi internet untuk berfungsi?
Tidak, server melakukan komputasi lokal murni tanpa panggilan jaringan, tidak ada state di antara panggilan, dan tidak ada data pengguna yang dibaca.
Apakah data Creed Commons merupakan kode yang dapat dieksekusi?
Tidak, Creed Commons mendistribusikan data bertanda (signed data) yang diinterpretasikan oleh values engine, sehingga memastikan data tersebut tidak pernah menjadi kode yang dapat dieksekusi.
Apakah mode transport HTTP memerlukan autentikasi?
Secara default, server tidak memiliki autentikasi; jika Anda melakukan binding di luar loopback, Anda harus menggunakan gateway atau reverse proxy untuk menangani autentikasi client.