AI Agent with Architectural Memory

Hokmah MCP Server

アーキテクチャの記憶を備えた AI エージェント — MCP サーバー

TransitionGraph、IdeaGraph、WorldModel を通じて、あらゆる AI コーディングエージェントにコードベースへの持続的な理解をもたらします。影響を分析し、テストを生成し、コードを記述できます。すべてグラフから行えます。

クイックスタート（30 秒）

エディターの MCP 設定に追加します（Cursor、Claude Code、VS Code、Windsurf、Cline、JetBrains）：

{
  "mcpServers": {
    "hokmah": {
      "type": "streamable-http",
      "url": "https://hokmah.dev/mcp"
    }
  }
}

次に、エージェントにこう尋ねます：「github.com/owner/repo の auth モジュールをリファクタリングした場合の影響を分析して」

利用可能なツール

ツール	プラン	説明
hokmah_analyze	無料	影響分析、リスクスコア、影響を受けるファイル、アーキテクチャ上の不変条件
hokmah_connect_project	無料	GitHub リポジトリに接続し、アーキテクチャグラフを構築
hokmah_connect_mcp	無料	オーケストレーション用に外部 MCP サーバーに接続
hokmah_generate_tests	プロ	グラフからテストを生成（トークンを 40 分の 1 に削減）
hokmah_generate_code	プロ	アーキテクチャの記憶を活用したコード生成

仕組み

Hokmah は、コードベースから永続的なアーキテクチャグラフを構築します：

• TransitionGraph — コード変更のマルコフモデル（どのファイルが一緒に変更されるか）
• IdeaGraph — 概念間の 16 種類の関係
• WorldModel — ファイルツリー、依存関係、シンボル

「X を変更した場合の影響は？」と尋ねると、Hokmah はコードベース全体を LLM に送信するのではなく、グラフをたどります。そのため、analyze は無料（LLM トークンを消費しません）で、generate はトークンを 40 分の 1 に削減できます。

料金

• 無料 — hokmah_analyze + hokmah_connect_project + hokmah_connect_mcp（無制限）
• プロ — hokmah_generate_tests + hokmah_generate_code（BYOK — 独自の LLM キーを使用）

hokmah.dev でプロキーを取得できます。

エディターの設定

• Cursor — Settings → MCP → Add server → 設定を貼り付け
• Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json
• Claude Code — claude mcp add hokmah --transport streamable-http --url https://hokmah.dev/mcp
• VS Code（Copilot） — プロジェクトルートの .vscode/mcp.json
• Windsurf — ~/.windsurf/mcp.json
• Cline — Settings → MCP Servers → Add
• JetBrains — Settings → Tools → AI Assistant → MCP Servers

セルフホスティング

Hokmah の利用には、ホスト型サーバー https://hokmah.dev/mcp を推奨します。独自の Hokmah バックエンドに対してサーバーを自分で実行するには：

pip install -r requirements.txt
cp pro_keys.example.json pro_keys.json  # edit with your real PRO keys
HOKMAH_API_BASE=http://localhost:8000 python mcp_server.py

環境変数：

• HOKMAH_API_BASE — 上流の Hokmah API（デフォルトは http://localhost:8000）
• HOKMAH_MCP_PORT — リッスンするポート（デフォルトは 8001）
• HOKMAH_PRO_KEYS — PRO キーの JSON ファイルへのパス（デフォルトは /home/vpm/mcp-server/pro_keys.json）

参照用の systemd ユニットが hokmah-mcp.service に用意されています。

開発元

Catalyst AI Research · イスラエル、ハイファ

ライセンス

MIT