ローカルのMarkdownプロファイルを使用して、AIツール向けのポータブルでプライバシー保護されたユーザーの好みとコンテキストを管理します。
別名 markoblogo/ID, id, id-protocol
- スター
- 1
- ツール
- —
- ダウンロード数(30日間)
- 451
- 最新バージョン
- 0.4.0
- 最終コミット
- 2026年10月23日
- ライセンス
- MIT
ID Protocol MCPとは
ローカルのMarkdownプロファイルを使用して、AIツール向けのポータブルでプライバシー保護されたユーザーの好みとコンテキストを管理します。
プロジェクトのREADMEから生成された概要
ID Protocol MCP server について
ID Protocolは、ローカルのMarkdownファイルを使用して、AIツール向けの個人の好みやコンテキストを管理する方法を提供します。ベンダー固有の設定に依存する代わりに、ユーザーはprofile.minimal.mdやprofile.core.mdなどのファイルを通じて、独自の信頼できる情報源を維持できます。このシステムにより、機密データを中央サーバーにアップロードすることなく、プライバシーでフィルタリングされたコンパクトなコンテキストを作成し、異なるAIエージェントやリポジトリ間で移動させることが可能になります。
このツールは、Python 3.11以降を必要とするローカルのCLIとして動作します。idctlコマンドを使用して、プロファイルの初期化、検証、およびsoul.mdやcontext.compact.jsonなどの特定のビューのエクスポートを行います。プライバシーポリシーシステムを使用することで、承認されたフィールドのみがエクスポートに含まれることを保証し、指定されたowner_idと一致しないデータはすべてブロックします。このセットアップは、AIクライアントがセッション中に受け取る情報を正確に制御したいユーザー向けに設計されています。
できること
- 1プライバシーでフィルタリングされたAIコンテキストの生成エクスポート用に承認した特定のユーザー設定のみを含む、コンパクトなJSONファイルを作成します。
- 2ローカルのプリファレンスファイルの維持自身で所有・管理するローカルのMarkdownファイルを使用して、作業上の制約や個人の好みを管理します。
- 3プロファイル変更の経時的な監査現在のプロファイルを1週間前の状態と比較して、何が変更されたかを確認します。
- 4エージェント用のブートストラップデータの準備AIエージェントに即座にコンテキストを提供するための、短いブートストラップファイルを生成します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
ID Protocol MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにID Protocol MCPをインストール
$ claude mcp add id -- uvx id-protocolCursorにID Protocol MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"id": {
"command": "uvx",
"args": [
"id-protocol"
]
}
}
}VS CodeにID Protocol MCPをインストール
.vscode/mcp.json
{
"servers": {
"id": {
"type": "stdio",
"command": "uvx",
"args": [
"id-protocol"
]
}
}
}VS Code CLIにID Protocol MCPをインストール
$ code --add-mcp '{"name":"id","type":"stdio","command":"uvx","args":["id-protocol"]}'Claude DesktopにID Protocol MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"id": {
"command": "uvx",
"args": [
"id-protocol"
]
}
}
}CodexにID Protocol MCPをインストール
$ codex mcp add id -- uvx id-protocolCodex config.tomlにID Protocol MCPをインストール
~/.codex/config.toml
[mcp_servers.id] command = "uvx" args = ["id-protocol"]
Gemini CLIにID Protocol MCPをインストール
$ gemini mcp add -s user id uvx -- id-protocolGemini settings.jsonにID Protocol MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"id": {
"command": "uvx",
"args": [
"id-protocol"
]
}
}
}自動チェック
実行日 2026年11月14日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能markoblogo/id is public and reachablegithub.com/markoblogo/id ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)Sigstore attestation for id-protocolpypi.org/project/id-protocol/ ↗合格
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-10-23github.com/markoblogo/id ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していないNo popular package one edit away from id-protocol合格
- パッケージおよびその依存関係に重大な勧告なし1 resolved dependencies checked; no critical advisoryosv.dev ↗合格
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見るID 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のよくある質問
ID Protocol MCPをClaude Codeに追加するには
ターミナルでclaude mcp add id -- uvx id-protocolを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
ID Protocol MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
ID Protocolはデータをサーバーにアップロードしますか?
いいえ、このツールはローカルのCLIであり、生成されたファイルをアップロードすることはありません。
プライバシーフィルタリングはどのように機能しますか?
エクスポートには、所有者IDがプロファイルと一致する有効なポリシーが必要です。リストに含まれていないフィールドはローカルのみに保持されます。
ID Protocolを実行するためのシステム要件は何ですか?
Python 3.11以降がインストールされている必要があります。