Skip to main content
Glama
deenesjakoruzh
drhalto

agentmako

by drhalto
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

agentmako

npm version Smoke Tests License: Apache 2.0 Node.js >=20 agentmako MCP server

agentmako 是一个面向 AI 编码工具的本地优先代码库智能引擎。

它为 Codex、Claude Code、Cursor 和本地工具链等代理提供了一个类型化的 MCP 工具集，以便在编辑代码之前理解项目。Mako 会索引你的仓库，构建基于 SQLite 的本地事实，跟踪诊断和审查记录，并返回结构化的上下文数据包，而不是让代理通过原始 grep 命令重新发现一切。

Mako 专为编码代理工作的“第一公里”而设计：

哪些文件重要？哪些路由、符号、表、诊断和先前的发现是相关的？代理接下来应该阅读什么？

你将获得什么

  • 编码代理的 MCP 服务器：agentmako mcp

  • 本地仪表盘：agentmako dashboard

  • 确定性的上下文数据包：context_packet, reef_scout

  • 代码搜索和结构工具：cross_search, live_text_search, ast_find_pattern, repo_map

  • Reef Engine 事实和发现，涵盖已索引、工作树和暂存状态

  • TypeScript、ESLint、Oxlint、Biome 和暂存 git 诊断摄取

  • 可选的 Postgres/Supabase 模式快照和只读数据库检查

  • 用于记录表、RLS、触发器、发布、订阅和复制的本地数据库审查注释

  • 用于重复审查工作的召回、确认和代理反馈

所有重要内容都在本地运行。无需托管服务。

Related MCP server: Context Zero Engine

安装

需要 Node.js 20 或更高版本。

npm install -g agentmako

确认 CLI 可用：

agentmako doctor

你应该会看到配置和本地 API 服务的绿色勾选。

倾向于从源码构建（例如为了贡献代码）？请参阅本文档底部的 从源码开发。

快乐路径设置

1. 关联你的真实项目

进入你希望 Mako 理解的项目：

cd C:/path/to/your/project

关联并索引它：

agentmako connect . --no-db

首次运行时使用 --no-db。它会在添加数据库范围之前先让代码智能路径正常工作。

2. 确认 Mako 能看到项目

agentmako status .
agentmako tool list

运行一次真实的侦察查询：

agentmako --json tool call . reef_scout "{\"query\":\"where should I inspect auth route state?\"}"

如果返回了排名候选、事实或发现，则核心设置已正常工作。

3. 配置你的 MCP 客户端

将此内容添加到你的 MCP 客户端配置中：

{
  "mcpServers": {
    "mako-ai": {
      "command": "agentmako",
      "args": ["mcp"]
    }
  }
}

重启 MCP 客户端并确认 mako-ai 服务器已启动。

在代理中，从以下工具之一开始：

  • tool_search：当你需要查找合适的 Mako 工具时

  • context_packet：当你有一个编码任务并想要初始上下文时

  • reef_scout：当你想要排名后的项目事实/发现/历史记录时

  • ask：当你有一个关于仓库的自然语言问题时

4. 可选：使用 Claude Code 插件

普通的 MCP 可以与 Claude Code 一起使用，但捆绑的插件添加了 Mako 特有的 Claude 技能，并在 mako-ai-claude-plugin/.mcp.json 中包含了相同的 agentmako mcp 配置。

先决条件：

  • 已安装 Claude Code

  • PATH 中有 Node.js 20+

  • 你的目标项目已通过 agentmako connect 关联

从 agentmako 仓库根目录：

claude plugin validate .\mako-ai-claude-plugin
claude --plugin-dir .\mako-ai-claude-plugin

在 Claude Code 中，运行 /mcp 并确认 mako-ai 已连接。

该插件公开了以下技能：

  • /mako-ai:mako-guide

  • /mako-ai:mako-discovery

  • /mako-ai:mako-trace

  • /mako-ai:mako-neighborhoods

  • /mako-ai:mako-graph

  • /mako-ai:mako-database

  • /mako-ai:mako-code-intel

  • /mako-ai:mako-workflow

当你希望 Claude Code 加载 Mako 特有的指导（关于调用哪些工具以及如何解释结果）时，请使用该插件。

5. 可选：启动仪表盘

从你的目标项目：

agentmako dashboard .

这将启动本地 API、工具链服务和 Web 仪表盘。

6. 可选：添加 Supabase/Postgres 感知

Mako 在没有数据库的情况下也能工作。仅在代码智能正常工作后添加此功能。

进行一次性交互式设置：

agentmako connect .

对于 CI 或使用环境变量的脚本化设置：

set DATABASE_URL=postgres://...
agentmako connect . --db-env DATABASE_URL --yes

然后刷新并验证本地模式快照：

agentmako refresh .
agentmako verify .

交互模式默认将数据库密钥存储在你的操作系统钥匙串中。项目配置存储的是引用，而不是明文数据库 URL。

日常工作循环

从目标项目：

agentmako status .
agentmako dashboard .
agentmako --json tool call . context_packet "{\"query\":\"fix the broken auth callback route\"}"

用于暂存审查检查：

agentmako git precommit . --json

用于数据库审查注释：

agentmako --json tool call . db_review_comment "{\"objectType\":\"replication\",\"objectName\":\"supabase_database_replication\",\"category\":\"review\",\"comment\":\"Check publication coverage before relying on realtime events.\",\"tags\":[\"supabase\",\"replication\"]}"

从源码开发

如果你想修改 Mako 本身，请克隆并构建，而不是从 npm 安装。

先决条件：

  • Node.js 20 或更高版本

  • Git

  • Corepack (corepack enable，现代 Node.js 已包含)

git clone https://github.com/drhalto/agentmako.git
cd agentmako
corepack pnpm install
corepack pnpm run build
npm link ./apps/cli

npm link ./apps/cli 使源码构建的 CLI 在你的 PATH 中作为 agentmako 可用，替换任何全局 npm 安装。拉取更改后重新运行 corepack pnpm run build。

要回到已发布版本：npm install -g agentmako。

开发检查

corepack pnpm run typecheck
corepack pnpm run build
corepack pnpm run test:smoke:reef-tooling
corepack pnpm run test:smoke:reef-model-facing-views

全面验证：

corepack pnpm test

仓库布局

apps/
  cli/              agentmako CLI and MCP entrypoint (the published package)
  web/              local dashboard
packages/
  contracts/        public TypeScript contracts and tool schemas
  config/           shared config helpers
  logger/           shared logger
  sdk/              programmatic SDK
  store/            SQLite stores, migrations, and query helpers
  tools/            shared tool implementations
  harness-core/     local agent harness runtime
  harness-tools/    action tools available to the harness
  harness-contracts/ harness contracts and provider catalog
services/
  api/              local API and MCP transports
  engine/           Reef Engine fact/finding pipeline
  harness/          local harness HTTP service
  indexer/          repo and schema indexing logic
  worker/           background worker
extensions/         provider and integration packages
storage/            schema migrations, models, queries
test/smoke/         smoke coverage
mako-ai-claude-plugin/ Claude Code plugin with Mako skills

更多文档

许可证

Apache-2.0。请参阅 LICENSE。

Install Server
A
license - permissive license
B
quality
A
maintenance

How are these scores calculated?

Maintenance

–Maintainers
2hResponse time
5dRelease cycle
13Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

  • Graft

    amaar-mc
    A
    license
    B
    quality
    D
    maintenance
    Local-first codebase context engine that parses code into a ranked dependency graph and serves it to AI tools via MCP for deep structural understanding.
    5
    8
    1
    MIT

  • Context Zero Engine

    Classevelabs
    A
    license
    Not graded
    quality
    A
    maintenance
    A local code-intelligence engine for AI agents that indexes repositories into a PostgreSQL-backed code graph and serves structured, token-budgeted context over MCP and HTTP, enabling targeted queries on symbols, dependencies, contracts, and impact analysis.
    Apache 2.0

  • Atlas

    Brair-Mpagi
    A
    license
    Not graded
    quality
    B
    maintenance
    A local-first codebase intelligence layer for AI coding agents, providing a persistent, queryable model of a repository via an MCP server and CLI to enable structure queries instead of reading many files.
    Apache 2.0

  • weavatrix-js

    sergii-ziborov
    A
    license
    Not graded
    quality
    A
    maintenance
    Local repository intelligence MCP server that builds a reusable graph of code structure for AI coding agents, providing 34 network-free tools for understanding, searching, and analyzing repositories without data leaving the machine.
    59
    MIT

View all related MCP servers

Related MCP Connectors

  • Maguyva

    Code intelligence for coding agents: semantic, AST, graph, and full-text search. 279+ languages.

  • ContextLattice

    Private-by-default, local-first memory/context/task orchestrator for MCP apps and agents.

  • Sprintra

    The project brain for AI coding agents — memory, decisions, sprints, knowledge base via MCP.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/drhalto/agentmako'

If you have feedback or need assistance with the MCP directory API, please join our Discord server