English Français العربية

Hokmah

Registre officiel Outils de développement

AI Agent with Architectural Memory. Impact analysis (free), tests and code from the graph (pro).

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http hokmah 'https://hokmah.dev/mcp'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "hokmah": {
            "type": "http",
            "url": "https://hokmah.dev/mcp"
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Hokmah MCP Server
  2. Quick Start (30 seconds)
  3. Available Tools
  4. How It Works
  5. Pricing
  6. Editor Setup
  7. Self-Hosting
  8. Built by
  9. License

Hokmah MCP Server

AI Agent with Architectural Memory — MCP Server

Gives any AI coding agent persistent understanding of codebases via TransitionGraph, IdeaGraph, and WorldModel. Analyze impact, generate tests, write code — all from the graph.

Quick Start (30 seconds)

Add to your editor's MCP config (Cursor, Claude Code, VS Code, Windsurf, Cline, JetBrains):

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

Then ask your agent: "analyze the impact of refactoring the auth module in github.com/owner/repo"

Available Tools

ToolTierDescription
hokmah_analyzeFREEImpact analysis, risk score, affected files, architectural invariants
hokmah_connect_projectFREEConnect a GitHub repo, build the architectural graph
hokmah_connect_mcpFREEConnect an external MCP server for orchestration
hokmah_generate_testsPROTest generation from the graph (40x fewer tokens)
hokmah_generate_codePROCode generation with architectural memory

How It Works

Hokmah builds a persistent architectural graph from your codebase:

  • TransitionGraph — Markov model of code changes (which files change together)
  • IdeaGraph — 16 relation types between concepts
  • WorldModel — File tree, dependencies, symbols

When you ask "what's the impact of changing X?", Hokmah traverses the graph instead of sending your entire codebase to an LLM. That's why analyze is free (zero LLM tokens) and generate uses 40x fewer tokens.

Pricing

  • Free — hokmah_analyze + hokmah_connect_project + hokmah_connect_mcp (unlimited)
  • Pro — hokmah_generate_tests + hokmah_generate_code (BYOK — bring your own LLM key)

Get a Pro key at hokmah.dev.

Editor Setup

  • Cursor — Settings → MCP → Add server → paste config
  • 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 in project root
  • Windsurf — ~/.windsurf/mcp.json
  • Cline — Settings → MCP Servers → Add
  • JetBrains — Settings → Tools → AI Assistant → MCP Servers

Self-Hosting

The hosted server at https://hokmah.dev/mcp is the recommended way to use Hokmah. To run the server yourself against your own Hokmah backend:

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

Environment variables:

  • HOKMAH_API_BASE — upstream Hokmah API (default http://localhost:8000)
  • HOKMAH_MCP_PORT — port to listen on (default 8001)
  • HOKMAH_PRO_KEYS — path to the PRO keys JSON file (default /home/vpm/mcp-server/pro_keys.json)

A reference systemd unit is provided in hokmah-mcp.service.

Built by

Catalyst AI Research · Haifa, Israel

License

MIT

Questions fréquentes

Qu'est-ce que Hokmah ?

AI Agent with Architectural Memory. Impact analysis (free), tests and code from the graph (pro).

Comment installer Hokmah ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http hokmah 'https://hokmah.dev/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Hokmah ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

Hokmah est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Hokmah ?

Il est publié par davidangularme. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.