Intelligent code context extraction for LLMs via Model Context Protocol

KIRI is an MCP server that provides intelligent code context extraction from Git repositories. It indexes your codebase into DuckDB and exposes semantic search tools for LLMs.

• MCP Native: Plug-and-play with Claude Desktop, Codex CLI, and other MCP clients
• Smart Context: Extract minimal, relevant code fragments based on task goals
• Accurate: MRR 1.0 — the most relevant file always ranks first
• Fast: Sub-second response time for most queries
• Semantic Search: Multi-word queries, dependency analysis, BM25 ranking
• Auto-Sync: Watch mode automatically re-indexes on file changes
• Phrase-Aware: Recognizes compound terms (kebab-case, snake_case)

npm install -g kiri-mcp-server

Or use npx without installation.

Edit ~/.claude/mcp.json:

{
  "mcpServers": {
    "kiri": {
      "command": "kiri",
      "args": ["--repo", ".", "--db", ".kiri/index.duckdb", "--watch"]
    }
  }
}

KIRI automatically indexes your repository on first startup.

Other MCP clients: See Setup Guide for Codex CLI and other configurations.

Full documentation: Tools Reference

Other languages are indexed but use full-file snippets instead of symbol extraction.

# Delete and rebuild
rm -rf .kiri/
# Restart MCP client - KIRI will automatically reindex

{
  "env": { "KIRI_DAEMON_READY_TIMEOUT": "480" }
}

rm -f .kiri/index.duckdb.sock.lock

pkill -f "kiri.*daemon"

More issues: See full troubleshooting guide below.

git clone https://github.com/CAPHTECH/kiri.git
cd kiri
pnpm install
pnpm run build
pnpm run test
pnpm run dev  # HTTP server on :8765

Guidelines: See AGENTS.md for development standards.

See CHANGELOG.md for release notes.

Recent highlights:

• v0.25.6: Fix daemon startup deadlock from v0.25.5
• v0.25.4: snippets_get content size handling improvements
• v0.25.3: Query language guidance in MCP tool descriptions (PR #182)
• v0.25.2: Auto reindex on DeserializeDeletes IO corruption (PR #181)

Problem: "Daemon did not become ready within X seconds"

Solutions:

1. Increase timeout (Claude Code: KIRI_DAEMON_READY_TIMEOUT=480, Codex CLI: startup_timeout_sec = 480)
2. Check logs: cat .kiri/index.duckdb.daemon.log
3. Manual test: kiri --repo . --db .kiri/index.duckdb --port 8765

# Verify installation
npm list -g kiri-mcp-server

# Re-link
npm link kiri-mcp-server

# Or use npx
npx kiri-mcp-server@latest --repo . --db .kiri/index.duckdb

1. Check size: git ls-files | wc -l
2. Review .gitignore
3. Add denylist: Create .kiri/denylist.yml:

patterns:
  - "**/*.min.js"
  - "**/vendor/**"

# Use pnpm link, not npm link
rm -rf node_modules pnpm-lock.yaml
pnpm install --frozen-lockfile
pnpm rebuild duckdb
pnpm run build
pnpm link --global

pkill -f "kiri.*daemon"
rm -f .kiri/index.duckdb.sock.lock .kiri/index.duckdb.sock
kiri --repo . --db .kiri/index.duckdb --full

1. Check logs: .kiri/index.duckdb.daemon.log
2. Enable debug: DEBUG=kiri:*
3. GitHub Issues
4. Discussions

MIT License - See LICENSE.

Built with Model Context Protocol, DuckDB, and tree-sitter.

Status: v0.25.6 (Beta) - Production-ready for MCP clients