MCP server Codemap
Коммит 1 нояб. 2026 г.Enables AI agents to query codebase structure, symbols, and imports using a local SQLite index to reduce token usage and file reads.
Также известен как stainless-code/codemap
- Звёзды
- 8
- Инструменты
- —
- Загрузки, 30 дней
- —
- Последняя версия
- —
- Последний коммит
- 1 нояб. 2026 г.
- Лицензия
- MIT
Что такое Codemap MCP?
Codemap — это MCP server. Enables AI agents to query codebase structure, symbols, and imports using a local SQLite index to reduce token usage and file reads.
Сводка сгенерирована из README проекта
О Codemap MCP server
Navigating complex codebases by querying structural metadata instead of scanning entire file trees is what codemap enables for AI agents. It creates a local SQLite index containing symbols, imports, calls, and other structural information to help agents answer questions about where specific components or definitions reside. This approach reduces token consumption and the number of file reads required by an AI client during a session.
Developers can set this up locally using Node or Bun to index a repository. The server supports both direct SQL queries and pre-defined recipes, such as find-symbol-definitions, to simplify common tasks. While it is not a replacement for grep or ripgrep for raw text searches, users can opt-in to FTS5 for full-text search capabilities when they need to join body matches with structural data. It works through a CLI or a programmatic ESM API for integration into custom workflows.
Что вы можете с ним делать
- 1Locating symbol definitionsAn AI agent can find exactly where a specific function or variable is defined using a single SQL command.
- 2Analyzing import directionsDevelopers can use the index to understand how different parts of a codebase interact through their imports.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Автоматические проверки
Запущено 15 нояб. 2026 г.Полный отчёт →Еще не проверено. Для сервера требуется оценка 80, отсутствие серьезных проблем и достаточно данных для нашей проверки. Как работают проверки · Что исправить, чтобы получить больше баллов
- Связанный и доступный исходный репозиторийstainless-code/codemap is public and reachablegithub.com/stainless-code/codemap ↗Пройдено
- Пакет указывает этот репозиторий как источникНе проверялось
- Происхождение сборки (аттестация Sigstore)Не проверялось
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний годLast commit or release 2026-11-01github.com/stainless-code/codemap ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетНе проверялось
- Нет критических предупреждений в пакете или его зависимостяхНе проверялось
- Нет скрытых инструкций для модели0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыНе проверялось
- Удалённая конечная точка отвечает на рукопожатие MCPНе проверялось
README
Открыть на GitHubCodemap
Query your codebase. Local codebase intelligence for AI agents — a SQLite index of symbols, imports, calls, and more structural metadata so agents answer “where / what / who” with SQL and recipes instead of scanning the tree.
- Not grep by default — use ripgrep / your IDE for raw text. Opt-in FTS5 (
--with-fts/fts5: true) when body matches need to JOIN with structure. - Is a fast, token-efficient way to navigate structure.
Docs: https://stainless-code.com/codemap
What you get
Structural questions in one SQL round-trip instead of 3–5 file reads — symbol definitions, import direction, components, CSS tokens, @deprecated symbols, and more. Named patterns ship as recipes (codemap query --recipe …); full catalog and schema live in the docs.
Install
bun add @stainless-code/codemap
# or: npm install @stainless-code/codemap
Engines: Node >=22.12.0 and/or Bun >=1.0.31.
CLI
codemap # incremental index
codemap query --json --recipe find-symbol-definitions --params name=foo
codemap query --json "SELECT name, file_path FROM symbols WHERE name = 'foo'"
codemap show foo
codemap agents init --mcp # agent templates + MCP
Full command reference, recipes, MCP/HTTP, config, and the GitHub Action: docs site.
Programmatic API (ESM)
import { createCodemap } from "@stainless-code/codemap";
const cm = await createCodemap({ root: "/path/to/repo" });
await cm.index({ mode: "incremental" });
const rows = cm.query("SELECT name FROM symbols LIMIT 5");
API reference: https://stainless-code.com/codemap/reference/api.
Development
Contributor workflow, checks, and conventions: .github/CONTRIBUTING.md.
bun install
bun run check
Maintainer hub: docs/README.md.
License
MIT — see LICENSE.
Вопросы о Codemap MCP
How does Codemap differ from grep?
Codemap is not grep by default; you should use ripgrep or your IDE for raw text searches, whereas Codemap is designed for navigating structural metadata.
What kind of information can I query?
You can query symbol definitions, import directions, components, CSS tokens, deprecated symbols, and more via SQL.
What are the engine requirements for installation?
The tool requires Node version 22.12.0 or higher, or Bun version 1.0.31 or higher.