Value Context Protocol을 사용하여 AI 클라이언트가 윤리 토큰을 검증하고, 컨텍스트 차원을 인코딩하며, 서명된 가치 아티팩트를 관리할 수 있도록 지원합니다.
다른 이름 Creed-Space/vcp-sdk-python, vcp-sdk-python, vcp-sdk
- 스타
- 0
- Tools
- 7
- 다운로드, 30일
- 273
- 최신 버전
- 0.8.0
- 마지막 커밋
- 2026년 11월 6일
- 라이선스
- Apache-2.0
vcp MCP란?
vcp은(는) MCP server입니다. Value Context Protocol을 사용하여 AI 클라이언트가 윤리 토큰을 검증하고, 컨텍스트 차원을 인코딩하며, 서명된 가치 아티팩트를 관리할 수 있도록 지원합니다. 7개 도구를 제공합니다. 예: vcp_status, vcp_validate_token, vcp_parse_csm1.
프로젝트 README에서 생성된 요약
vcp MCP server 정보
vcp-mcp는 AI 클라이언트 내부에서 AI 윤리 토큰을 검증하고 컨텍스트 차원을 인코딩할 수 있게 해줍니다. 이 MCP server는 Value Context Protocol로 연결되는 브릿지 역할을 하며, 개발자가 표준화된 프레임워크를 통해 서명된 가치 아티팩트를 관리하고 페르소나 준수 여부를 확인할 수 있도록 지원합니다. stdio 또는 상태가 없는 HTTP 전송 방식을 통해 실행되는 로컬 연산 도구로 작동하며, 처리 과정에서 사용자 데이터를 읽거나 네트워크 호출을 수행하지 않습니다.
사용자는 VCP/I 토큰을 파싱하는 vcp_validate_token, 18가지 컨텍스트 차원을 와이어 포맷으로 변환하는 vcp_encode_context, 원칙을 Schwartz 가치로 매핑하는 creed_classify_principle 등의 도구를 사용하여 서버와 상호작용할 수 있습니다. 이 서버는 Claude Desktop 또는 Claude Code와 같은 클라이언트와 통합되도록 설계되었습니다. 로컬 사용 시에는 인증이 필요하지 않지만, 서버 자체에 인증 기능이 없으므로 원격 HTTP 배포 시에는 게이트웨이나 리버스 프록시로 보호해야 합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
vcp MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 vcp MCP 설치
$ claude mcp add vcp-sdk-python -- uvx vcp-sdkCursor에 vcp MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"vcp-sdk-python": {
"command": "uvx",
"args": [
"vcp-sdk"
]
}
}
}VS Code에 vcp MCP 설치
.vscode/mcp.json
{
"servers": {
"vcp-sdk-python": {
"type": "stdio",
"command": "uvx",
"args": [
"vcp-sdk"
]
}
}
}VS Code CLI에 vcp MCP 설치
$ code --add-mcp '{"name":"vcp-sdk-python","type":"stdio","command":"uvx","args":["vcp-sdk"]}'Claude Desktop에 vcp MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"vcp-sdk-python": {
"command": "uvx",
"args": [
"vcp-sdk"
]
}
}
}Codex에 vcp MCP 설치
$ codex mcp add vcp-sdk-python -- uvx vcp-sdkCodex config.toml에 vcp MCP 설치
~/.codex/config.toml
[mcp_servers.vcp-sdk-python] command = "uvx" args = ["vcp-sdk"]
Gemini CLI에 vcp MCP 설치
$ gemini mcp add -s user vcp-sdk-python uvx -- vcp-sdkGemini settings.json에 vcp MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"vcp-sdk-python": {
"command": "uvx",
"args": [
"vcp-sdk"
]
}
}
}vcp MCP 도구 7
README에서 감지됨vcp_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 | — |
구성
VCP_MCP_ALLOW_INSECURE_HTTP
| 이름 | 설명 | 유형 |
|---|---|---|
| VCP_MCP_ALLOW_INSECURE_HTTP | — |
자동 검사
2026년 11월 13일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)통과
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음통과
- 원격 엔드포인트가 HTTPS 사용검사되지 않음
- 파괴적인 도구에 라벨 표시됨통과
- 모델에 대한 숨겨진 지침 없음통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음통과
README
GitHub에서 보기vcp-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 질문
vcp MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add vcp-sdk-python -- uvx vcp-sdk를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
vcp MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
vcp MCP는 어떤 도구를 제공하나요?
7개 도구를 제공합니다. 예: vcp_status, vcp_validate_token, vcp_parse_csm1, vcp_encode_context, vcp_validate_lite.
서버 작동을 위해 인터넷 연결이 필요한가요?
아니요, 이 서버는 네트워크 호출, 호출 간 상태 유지, 사용자 데이터 읽기 없이 순수 로컬 연산만 수행합니다.
Creed Commons 데이터는 실행 가능한 코드인가요?
아니요, Creed Commons는 가치 엔진이 해석하는 서명된 데이터를 배포하며, 이는 절대로 실행 가능한 코드가 아닙니다.
HTTP 전송 모드에서 인증이 필요한가요?
기본적으로 서버에는 인증 기능이 없습니다. 루프백 이외의 환경에 바인딩하는 경우, 클라이언트 인증을 처리할 게이트웨이나 리버스 프록시를 사용해야 합니다.