get_knowledge_root        目次の入口（ROOT.md）
   ↓ 分類を選ぶ
get_knowledge_index       分類ごとの一覧（knowledge/{分類}/INDEX.md）
   ↓ 記録を選ぶ
get_knowledge_record      記録の本文

目次の表記    path: `knowledge/policy/20260805T060019Z-abc.md`
                     └─ category ─┘ └────── filename ──────┘

save_knowledge
  → POST /repos/{owner}/{repo}/dispatches
     （event_type: save_knowledge・日本語のまま送る）
        ↓
  保管庫の GitHub Actions が起動
        ↓
  形式変換 → コミット → 目次の再生成 → 個人情報チェック

poetry install

cp .env.example .env

対象リポジトリ : 保管庫の1つだけ
権限          : Contents — Read and write
付与しないもの : Actions / Issues / Administration / Workflows

# stdio（ローカルのMCPクライアント向け）
poetry run knowledge-mcp

# Streamable HTTP（リモート接続向け）
MCP_TRANSPORT=streamable-http poetry run knowledge-mcp

{"timestamp":"2026-09-01T05:12:33.123Z","level":"WARNING","logger":"knowledge_mcp.audit",
 "message":"tool.denied",
 "extra":{"tool":"get_knowledge_index","request_id":"71346ae6020f",
          "category":"../.github/workflows","outcome":"denied",
          "reason":"validation_error","duration_ms":0.1}}

grep '71346ae6020f' server.log

jq 'select(.extra.tool=="save_knowledge")' server.log
jq 'select(.message=="tool.denied")' server.log
jq 'select(.extra.duration_ms > 3000)' server.log

from mcp.server import MCPServer
from chatwork_mcp.interfaces.mcp_tools import register as register_chatwork
from knowledge_mcp.interfaces.mcp_tools import register as register_knowledge

server = MCPServer("integration", version="1.0.0")
register_chatwork(server)
register_knowledge(server)
server.run(transport="stdio")

src/knowledge_mcp/
├── domain/              外部に依存しない。保管庫の構造と検証ルール
│   ├── models.py
│   └── validators.py
├── application/         ユースケース
│   └── usecases.py
├── infrastructure/      外部との接続
│   ├── config.py
│   ├── github_client.py
│   └── rate_limiter.py
├── interfaces/          MCPとの接続
│   └── mcp_tools.py
├── observability/       運用のための記録
│   ├── audit.py         操作の記録と相関ID
│   └── log_config.py    出力形式・秘密情報の伏せ字・保存先
└── mcp_server.py        エントリポイント

poetry run pytest