AI Agent with Architectural Memory

Name: AI Agent with Architectural Memory
Author: davidangularme

远程服务

github.com/davidangularmeAI 与智能体027 周前更新

代码仓库

关于 AI Agent with Architectural Memory

Hokmah MCP Server 通过持久化架构图，为编码 Agent 提供代码库影响分析、测试生成和代码生成能力。它可连接 GitHub 项目及外部 MCP 服务，并提供免费分析工具和 PRO 生成工具。

主要功能

01持久化代码库架构图
02重构影响与风险分析
03连接 GitHub 项目和 MCP 服务
04基于架构图生成测试与代码

适用场景

01评估重构可能影响的文件
02连接 GitHub 仓库进行分析
03利用架构上下文生成测试

MCP 相关

向 MCP 客户端提供五种工具，用于连接项目、分析影响、编排外部 MCP 服务，以及生成测试和代码。

#testing #code-analysis #architectural-memory #impact-analysis

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://hokmah.dev/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http hokmah https://hokmah.dev/mcp

Cursor.cursor/mcp.json{"mcpServers":{"hokmah":{"type":"http","url":"https://hokmah.dev/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"hokmah":{"type":"http","url":"https://hokmah.dev/mcp"}}}在 VS Code 中打开

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

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"hokmah":{"serverUrl":"https://hokmah.dev/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

参数	类型	必填
repo_url	string	是
query	string	是
branch	string	否

详细介绍

Hokmah MCP Server

具备架构记忆的 AI Agent — MCP 服务

通过 TransitionGraph、IdeaGraph 和 WorldModel，让任何 AI 编码 Agent 都能持久理解代码库。分析影响、生成测试、编写代码——一切都基于图谱。

快速开始（30 秒）

将以下内容添加到编辑器的 MCP 配置中（Cursor、Claude Code、VS Code、Windsurf、Cline、JetBrains）：

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

然后向你的 Agent 提问：“分析重构 github.com/owner/repo 中 auth 模块的影响”

可用工具

工具	级别	描述
`hokmah_analyze`	免费	影响分析、风险评分、受影响文件、架构不变量
`hokmah_connect_project`	免费	连接 GitHub 仓库，构建架构图
`hokmah_connect_mcp`	免费	连接外部 MCP 服务以进行编排
`hokmah_generate_tests`	专业版	基于图谱生成测试（减少 40 倍令牌用量）
`hokmah_generate_code`	专业版	借助架构记忆生成代码

工作原理

Hokmah 会根据你的代码库构建持久化的架构图：

TransitionGraph — 代码变更的马尔可夫模型（哪些文件会一起变更）
IdeaGraph — 概念之间的 16 种关系类型
WorldModel — 文件树、依赖关系、符号

当你询问“更改 X 会有什么影响？”时，Hokmah 会遍历图谱，而不是将整个代码库发送给大模型。因此，analyze 免费（不消耗大模型令牌），而 generate 的令牌用量减少 40 倍。

定价

免费版 — hokmah_analyze + hokmah_connect_project + hokmah_connect_mcp（不限量）
专业版 — hokmah_generate_tests + hokmah_generate_code（BYOK — 使用你自己的大模型密钥）

在 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

自托管

推荐使用托管服务 https://hokmah.dev/mcp 来运行 Hokmah。若要针对自己的 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。