Hokmah

io.github.davidangularme由 GitHub 账号 davidangularme 发布v1.0.0更新于 Oct 24, 2026

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

已验证Streamable HTTP可网页运行知识与记忆开发者工具

概览

AI 生成的概览

Hokmah 是一个远程 MCP 服务器，可将公开 GitHub 仓库导入架构图，让助手评估所描述代码变更的影响。

可以做什么
导入公开 GitHub 仓库，将其源文件与近期提交索引为依赖与变更历史图；branch 参数仅为兼容而接受，实际使用默认分支。评估所描述代码变更对已导入仓库的影响，返回风险评分、受影响文件与架构不变量。连接外部 MCP 服务器以进行编排。README 还列出专业版从图中生成测试与代码，但这些不在本清单声明的工具中。
适用场景
当你希望助手在不把整个代码库发送给模型的情况下，评估公开 GitHub 仓库中某次重构或变更的影响范围，并希望跨会话保留该仓库的架构视图时适用。
运行要求
需要远程 streamable HTTP 端点，无需本地运行时或安装包。仓库必须在 GitHub 上公开。托管端点未声明身份验证。自托管需要 Python、上游 Hokmah 后端，以及 HOKMAH_API_BASE、HOKMAH_MCP_PORT 和 HOKMAH_PRO_KEYS 设置。
安装前请注意
导入仓库会把其源文件和提交历史发送到第三方托管服务。README 描述了付费专业版，使用你自己的 LLM 密钥生成测试和代码，并需从厂商获取 Pro 密钥；声明的工具不包含这些。分析结果来自图模型的估算，并非经过验证的测试结果。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Hokmah，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.davidangularme%2Fhokmah/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

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

README

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):

json
{  "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:

bash
pip install -r requirements.txtcp pro_keys.example.json pro_keys.json  # edit with your real PRO keysHOKMAH_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

来源：README.md，提交 78d5b00

工具

2

hokmah_analyze

Analyze Change Impact

Estimates the impact of a described code change on an imported public GitHub repository. `repo_url` is https://github.com/<owner>/<repository> and `query` describes the change in plain language; `branch` is accepted for compatibility, the analysis uses the history imported from the default branch. Returns a risk assessment with the files, symbols and modules likely to be affected and related commits, computed from the repository graph without a language model.

输入参数query必填branchrepo_url必填

hokmah_connect_project

Import Public GitHub Repository

Imports a public GitHub repository so it can be analyzed: indexes its source files (.py .js .ts .jsx .tsx .rs .go .java) and its latest commits (up to 500) from the default branch into a dependency and change-history graph. `repo_url` is https://github.com/<owner>/<repository>; `branch` is accepted for compatibility. A repository already imported is not imported again. Returns the project id and the number of commits and files ingested.

输入参数branchrepo_url必填

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分