Value Context Protocolを使用して、AIクライアントによる倫理トークンの検証、コンテキスト次元のエンコード、および署名済みバリューアーティファクトの管理を可能にします。
別名 Creed-Space/vcp-sdk-python, vcp-sdk-python, vcp-sdk
- スター
- 0
- ツール
- 7
- ダウンロード数(30日間)
- 273
- 最新バージョン
- 0.8.0
- 最終コミット
- 2026年11月6日
- ライセンス
- Apache-2.0
vcp MCPとは
vcpはMCPサーバーです。 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 valuesにマッピングする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を開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
vcp MCPが提供するツールは
7個のツールを提供しており、vcp_status, vcp_validate_token, vcp_parse_csm1, vcp_encode_context, vcp_validate_liteなどがあります。
動作にはインターネット接続が必要ですか?
いいえ、このサーバーは純粋なローカル計算のみを行い、ネットワークコール、呼び出し間の状態保持、およびユーザーデータの読み取りは一切行いません。
Creed Commonsのデータは実行可能なコードですか?
いいえ、Creed Commonsが配布するのは署名済みデータであり、バリューエンジンがそれを解釈します。実行可能なコードが含まれることはありません。
HTTPトランスポートモードでは認証が必要ですか?
デフォルトでは、サーバーに認証機能はありません。ループバック以外にバインドする場合は、ゲートウェイまたはリバースプロキシを使用してクライアント認証を処理する必要があります。