akf

mcp-server-akf

mcp-name: io.github.HMAKT99/akf

AI エージェントに 10 個の AKF ツールを提供する MCP（Model Context Protocol）サーバーです。 MCP 互換クライアント（Claude Desktop、Claude Code、Cursor、Windsurf など）を使って、 Agent Knowledge Format によりファイルの確認、スタンプ付与、検証、監査、スキャンができます。

スタンプの付与には約 15 トークンかかります。再検証には 15,000 トークンかかります。 エージェントは検証したファイルにスタンプを付与します。次のエージェントは check_file を呼び出して、その作業をやり直す代わりに成果を引き継ぎます。

インストール

pip install mcp-server-akf

設定

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "akf": {
      "command": "python",
      "args": ["-m", "mcp_server_akf"]
    }
  }
}

Cursor

プロジェクトのルートにある .cursor/mcp.json に追加します。

{
  "mcpServers": {
    "akf": {
      "command": "python",
      "args": ["-m", "mcp_server_akf"]
    }
  }
}

ツール

ツール	説明
check_file	信頼性を 1 行で確認します。このファイルを再検証せずにエージェントが引き継いで作業できますか？（OK / LOW / STALE / UNSTAMPED）
create_claim	信頼性メタデータ付きの AKF クレームを作成します
validate_file	仕様に照らして .akf ファイルを検証します
scan_file	AKF メタデータがあるか、任意のファイルをセキュリティスキャンします
trust_score	クレームの実効信頼スコアを算出します
stamp_file	任意のファイルに信頼性メタデータをスタンプします（20 以上の形式）
audit_file	コンプライアンス監査を実施します（EU AI Act、SOX、HIPAA、GDPR、NIST、ISO 42001）
embed_file	DOCX、PDF、HTML、画像などに AKF メタデータを埋め込みます
extract_file	対応する任意の形式から AKF メタデータを抽出します
detect_threats	AI 固有のセキュリティ検出を 10 種類実行します

簡単な使い方

設定が完了したら、AI エージェントに次のように依頼します。

「report.docx に AKF 信頼性メタデータをスタンプしてください。信頼度は 0.9、証拠は『四半期レビュー完了』です」

エージェントは MCP 経由で stamp_file を呼び出し、来歴情報を自動的に付加します。

テスト用にサーバーを直接実行することもできます。

python -m mcp_server_akf

ツールの結果に含まれる検証状態（実験的機能）

mcp 2.x では、ファイルに関するツールの結果（path を指定して呼び出したすべてのツール）に、そのファイルの検証状態が _meta 内のベンダーキー dev.akf/trust として含まれます。

"_meta": {
  "dev.akf/trust": {
    "v": "1",
    "status": "OK",
    "trust": 0.7447,
    "evidence": ["human_review"],
    "agent": "claude-code",
    "age_days": 4
  }
}

status はその場で算出されるため（OK / LOW / STALE / UNSTAMPED）、クライアントは検証後にファイルが変更されたかどうかを確認できます。結果がファイルに関するものでない場合、このキーは含まれません。このキーを認識しないクライアントは無視します。

独自サーバーの結果に注釈を付けるには、次のようにします。

from mcp_server_akf.meta import TRUST_META_KEY, trust_meta

meta = trust_meta(path)
return CallToolResult(content=[...], _meta={TRUST_META_KEY: meta} if meta else None)

クライアントで読み取るには、次のようにします。

result = await client.call_tool("extract_file", {"path": "report.md"})
state = (result.meta or {}).get("dev.akf/trust")
if state and state["status"] == "OK":
    ...  # verified and unchanged: build on it without re-verifying

マルチエージェントのサポート

この MCP サーバーは、マルチエージェントのオーケストレーションプラットフォームとシームレスに連携します。

• エージェントの識別情報：akf agent create / akf agent verify を使ってエージェントカードを作成、検証します
• A2A プロトコル：akf agent export-a2a を使ってエージェントカードをエクスポート／インポートし、プラットフォーム間で検出できるようにします
• チーム認証：akf certify --team を使って、CI でエージェントごとの信頼性の内訳を確認します
• 委任：エージェントが作業を引き継ぐ際、信頼性の上限によって委任された出力を制限します
• チームストリーミング：エージェントごとのクレーム帰属情報を含むマルチエージェントセッション

対応プラットフォーム：Claude Agent Teams、Copilot Cowork、Codex multi-agent、および A2A 互換プラットフォーム。

要件

• Python >= 3.10
• akf >= 1.0.0
• mcp >= 1.0.0