repoindex

Highlights

MCP Server (repoindex mcp)

LLM access to the repoindex database via Model Context Protocol (stdio transport). Four tools:

• get_manifest — database overview (tables, row counts, languages, last refresh)
• get_schema — SQL DDL introspection for one or all tables
• run_sql — read-only SQL queries (SELECT/WITH, max 500 rows)
• refresh — trigger database refresh

Install with: pip install repoindex[mcp]

render renamed to export

The render command is now export (with render kept as a hidden deprecated alias). All existing usage continues to work.

HTML Export (repoindex export html -o <dir>)

Self-contained index.html with embedded SQLite database, powered by sql.js (CDN). Features:

• Tabbed views for repos, events, tags, publications
• Interactive SQL console
• Column sorting and filtering
• Dark theme

Arkiv Directory Export (repoindex export arkiv -o <dir>)

Full archive output with:

• repos.jsonl and events.jsonl in arkiv universal record format
• README.md with YAML frontmatter
• schema.yaml describing all fields

Security

• SQL injection prevention via identifier validation in MCP get_schema
• XSS prevention in HTML export via DOM-based text escaping
• All MCP database access is read-only

Changes

• d6f8bb6 feat: add mcp optional dependency
• a176f65 feat: Add MCP server module with 4 tools
• ed95570 feat(mcp): wire FastMCP server and add 'repoindex mcp' CLI command
• 801ceb5 refactor: rename render command to export (render kept as deprecated alias)
• 188c30f feat: Add arkiv directory export with full archive output
• b52d71d feat: add HTML export — self-contained SQLite browser with sql.js
• d9fea38 fix: address code review findings — security, resource leaks, test coverage
• 86fddb0 refactor: simplify MCP server — _open_db helper, fetchmany, push event filter to SQL

Full Changelog: https://github.com/queelius/repoindex/compare/v0.10.1...v0.12.0