# Claude Code Indexer
[](https://badge.fury.io/py/claude-code-indexer)
[](https://pypi.org/project/claude-code-indexer/)
[](https://opensource.org/licenses/MIT)
## 🚀 Quick Install with VS Code
[](https://vscode.dev/redirect/mcp/install?name=claude-code-indexer&config=%7B%22command%22%3A%22python%22%2C%22args%22%3A%5B%22-m%22%2C%22claude_code_indexer.mcp_server%22%5D%7D)
[](https://insiders.vscode.dev/redirect/mcp/install?name=claude-code-indexer&config=%7B%22command%22%3A%22python%22%2C%22args%22%3A%5B%22-m%22%2C%22claude_code_indexer.mcp_server%22%5D%7D&quality=insiders)
## 📖 Description
Multi-language code indexing with graph database, supports Python/JavaScript/TypeScript/Java/AutoIt, auto-ignores node_modules/.git, respects .gitignore, multi-keyword search, MCP for Claude Desktop, automated installation.
## 🎯 Features
- **Multi-language Support**: Python, JavaScript, TypeScript, Java, AutoIt
- **Graph Database**: Advanced code relationship mapping using Ensmallen
- **Smart Ignoring**: Automatically respects .gitignore and skips node_modules/.git
- **Fast Search**: Multi-keyword search with FTS5 full-text search
- **MCP Integration**: Seamless integration with Claude Desktop/VS Code
- **Performance**: ~50 files/sec with caching enabled
- **AI Enhancement**: Optional AI-powered metadata generation
## 📦 Installation
### Via pip (Recommended)
```bash
pip install claude-code-indexer
```
### Via VS Code MCP
Click one of the badges above to automatically configure Claude Code Indexer as an MCP server in VS Code.
### Manual MCP Setup
```bash
# Install the package
pip install claude-code-indexer
# Setup MCP integration
cci mcp install
```
## 🚀 Quick Start
```bash
# Initialize project
cci init
# Index codebase
cci index .
# Search code
cci search "authentication"
# Find important components
cci query --important
# Get insights
cci insights
```
## 📊 Commands
### Core Commands
- `cci init` - Initialize project with CLAUDE.md and database
- `cci index [path]` - Index source code into graph database
- `cci stats` - Show project statistics
### Query Commands
- `cci query [--important] [--type TYPE] [--limit N]` - Query indexed entities
- `cci search <keywords>` - Full-text search across codebase
- `cci critical [--limit N]` - Find most critical components
### Analysis Commands
- `cci insights` - Architectural analysis and health check
- `cci enhanced [filters]` - Query AI-enhanced metadata
- `cci enhance . [--limit N]` - Add AI-powered metadata (requires API)
### State Management
- `cci state capture` - Save codebase snapshot
- `cci state diff` - Show changes since last capture
- `cci state tasks` - List development task history
### MCP Integration
- `cci mcp install` - Setup MCP server for Claude
- `cci mcp-daemon [start|stop|status]` - Background service management
## 🔧 MCP Server Configuration
When installed via VS Code badges or manual MCP setup, the server provides these tools:
### Available MCP Tools
- `index_codebase` - Index project code
- `search_code` - Search codebase with keywords
- `query_important_code` - Find critical components
- `get_project_stats` - Get project statistics
- `get_codebase_insights` - Health and architecture analysis
- `enhance_metadata` - Add AI-powered metadata
- `store_llm_memory` - Store analysis insights
- `store_coding_pattern` - Save reusable patterns
- `store_best_practice` - Document best practices
## 📈 Performance
| Operation | First Run | With Cache | Notes |
|-----------|-----------|------------|-------|
| init | 1-2s | N/A | One-time |
| index | 5-10s | 0.5-1s | 95%+ cache hit |
| query | 0.1-0.5s | 0.05s | Database query |
| search | 0.2-1s | 0.1s | Full-text search |
## ⚠️ Security
- **Never index sensitive data** (API keys, tokens, credentials)
- Check for .env files: `find . -name "*.env"`
- Add sensitive files to .gitignore
## 🤝 Contributing
Issues and pull requests are welcome at [GitHub](https://github.com/tuannx/claude-prompts).
## 📄 License
MIT License - see LICENSE file for details.
## 🔗 Links
- [Homepage](https://github.com/tuannx/claude-prompts/tree/main/claude_code_indexer)
- [Documentation](https://github.com/tuannx/claude-prompts/tree/main/claude_code_indexer/README.md)
- [Issues](https://github.com/tuannx/claude-prompts/issues)
- [PyPI](https://pypi.org/project/claude-code-indexer/)
Raw data
{
"_id": null,
"home_page": null,
"name": "claude-code-indexer",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "Tony Nguyen <tony@startupascent.net>",
"keywords": "code-indexing, graph-database, ensmallen, claude, code-analysis, ast, development-tools",
"author": null,
"author_email": "Tony Nguyen <tony@startupascent.net>",
"download_url": "https://files.pythonhosted.org/packages/81/f0/3c6a2289fa1c649b61083d99a5182895f19619c239e3bb97ba9529dba59d/claude_code_indexer-1.29.0.tar.gz",
"platform": null,
"description": "# Claude Code Indexer\n\n[](https://badge.fury.io/py/claude-code-indexer)\n[](https://pypi.org/project/claude-code-indexer/)\n[](https://opensource.org/licenses/MIT)\n\n## \ud83d\ude80 Quick Install with VS Code\n\n[](https://vscode.dev/redirect/mcp/install?name=claude-code-indexer&config=%7B%22command%22%3A%22python%22%2C%22args%22%3A%5B%22-m%22%2C%22claude_code_indexer.mcp_server%22%5D%7D)\n[](https://insiders.vscode.dev/redirect/mcp/install?name=claude-code-indexer&config=%7B%22command%22%3A%22python%22%2C%22args%22%3A%5B%22-m%22%2C%22claude_code_indexer.mcp_server%22%5D%7D&quality=insiders)\n\n## \ud83d\udcd6 Description\n\nMulti-language code indexing with graph database, supports Python/JavaScript/TypeScript/Java/AutoIt, auto-ignores node_modules/.git, respects .gitignore, multi-keyword search, MCP for Claude Desktop, automated installation.\n\n## \ud83c\udfaf Features\n\n- **Multi-language Support**: Python, JavaScript, TypeScript, Java, AutoIt\n- **Graph Database**: Advanced code relationship mapping using Ensmallen\n- **Smart Ignoring**: Automatically respects .gitignore and skips node_modules/.git\n- **Fast Search**: Multi-keyword search with FTS5 full-text search\n- **MCP Integration**: Seamless integration with Claude Desktop/VS Code\n- **Performance**: ~50 files/sec with caching enabled\n- **AI Enhancement**: Optional AI-powered metadata generation\n\n## \ud83d\udce6 Installation\n\n### Via pip (Recommended)\n```bash\npip install claude-code-indexer\n```\n\n### Via VS Code MCP\nClick one of the badges above to automatically configure Claude Code Indexer as an MCP server in VS Code.\n\n### Manual MCP Setup\n```bash\n# Install the package\npip install claude-code-indexer\n\n# Setup MCP integration\ncci mcp install\n```\n\n## \ud83d\ude80 Quick Start\n\n```bash\n# Initialize project\ncci init\n\n# Index codebase\ncci index .\n\n# Search code\ncci search \"authentication\"\n\n# Find important components\ncci query --important\n\n# Get insights\ncci insights\n```\n\n## \ud83d\udcca Commands\n\n### Core Commands\n- `cci init` - Initialize project with CLAUDE.md and database\n- `cci index [path]` - Index source code into graph database\n- `cci stats` - Show project statistics\n\n### Query Commands\n- `cci query [--important] [--type TYPE] [--limit N]` - Query indexed entities\n- `cci search <keywords>` - Full-text search across codebase\n- `cci critical [--limit N]` - Find most critical components\n\n### Analysis Commands\n- `cci insights` - Architectural analysis and health check\n- `cci enhanced [filters]` - Query AI-enhanced metadata\n- `cci enhance . [--limit N]` - Add AI-powered metadata (requires API)\n\n### State Management\n- `cci state capture` - Save codebase snapshot\n- `cci state diff` - Show changes since last capture\n- `cci state tasks` - List development task history\n\n### MCP Integration\n- `cci mcp install` - Setup MCP server for Claude\n- `cci mcp-daemon [start|stop|status]` - Background service management\n\n## \ud83d\udd27 MCP Server Configuration\n\nWhen installed via VS Code badges or manual MCP setup, the server provides these tools:\n\n### Available MCP Tools\n- `index_codebase` - Index project code\n- `search_code` - Search codebase with keywords\n- `query_important_code` - Find critical components\n- `get_project_stats` - Get project statistics\n- `get_codebase_insights` - Health and architecture analysis\n- `enhance_metadata` - Add AI-powered metadata\n- `store_llm_memory` - Store analysis insights\n- `store_coding_pattern` - Save reusable patterns\n- `store_best_practice` - Document best practices\n\n## \ud83d\udcc8 Performance\n\n| Operation | First Run | With Cache | Notes |\n|-----------|-----------|------------|-------|\n| init | 1-2s | N/A | One-time |\n| index | 5-10s | 0.5-1s | 95%+ cache hit |\n| query | 0.1-0.5s | 0.05s | Database query |\n| search | 0.2-1s | 0.1s | Full-text search |\n\n## \u26a0\ufe0f Security\n\n- **Never index sensitive data** (API keys, tokens, credentials)\n- Check for .env files: `find . -name \"*.env\"`\n- Add sensitive files to .gitignore\n\n## \ud83e\udd1d Contributing\n\nIssues and pull requests are welcome at [GitHub](https://github.com/tuannx/claude-prompts).\n\n## \ud83d\udcc4 License\n\nMIT License - see LICENSE file for details.\n\n## \ud83d\udd17 Links\n\n- [Homepage](https://github.com/tuannx/claude-prompts/tree/main/claude_code_indexer)\n- [Documentation](https://github.com/tuannx/claude-prompts/tree/main/claude_code_indexer/README.md)\n- [Issues](https://github.com/tuannx/claude-prompts/issues)\n- [PyPI](https://pypi.org/project/claude-code-indexer/)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Multi-language code indexing with graph database, supports Python/JavaScript/TypeScript/Java/AutoIt, auto-ignores node_modules/.git, respects .gitignore, multi-keyword search, MCP for Claude Desktop, automated installation",
"version": "1.29.0",
"project_urls": {
"Changelog": "https://github.com/tuannx/claude-prompts/blob/main/claude_code_indexer/CHANGELOG.md",
"Documentation": "https://github.com/tuannx/claude-prompts/tree/main/claude_code_indexer/README.md",
"Homepage": "https://github.com/tuannx/claude-prompts/tree/main/claude_code_indexer",
"Issues": "https://github.com/tuannx/claude-prompts/issues",
"Repository": "https://github.com/tuannx/claude-prompts.git"
},
"split_keywords": [
"code-indexing",
" graph-database",
" ensmallen",
" claude",
" code-analysis",
" ast",
" development-tools"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "d85d920434c471155ec85ed612f7b6ee8bfaf8edfe04dc76513e791f2f63662f",
"md5": "116f77811db77e2f305f9a39567d40dc",
"sha256": "953bee86c08dfa584a7ea1448fcec70f158827a9a88ecea4c4f7c65d0892b0b3"
},
"downloads": -1,
"filename": "claude_code_indexer-1.29.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "116f77811db77e2f305f9a39567d40dc",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 177959,
"upload_time": "2025-09-12T14:28:28",
"upload_time_iso_8601": "2025-09-12T14:28:28.754951Z",
"url": "https://files.pythonhosted.org/packages/d8/5d/920434c471155ec85ed612f7b6ee8bfaf8edfe04dc76513e791f2f63662f/claude_code_indexer-1.29.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "81f03c6a2289fa1c649b61083d99a5182895f19619c239e3bb97ba9529dba59d",
"md5": "431098531e7c5292cd6d87455c1e3ece",
"sha256": "067025627128aad26dbe0697b48a5b78de742b47a13e316dd119fdd693d72ebd"
},
"downloads": -1,
"filename": "claude_code_indexer-1.29.0.tar.gz",
"has_sig": false,
"md5_digest": "431098531e7c5292cd6d87455c1e3ece",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 243232,
"upload_time": "2025-09-12T14:28:29",
"upload_time_iso_8601": "2025-09-12T14:28:29.799294Z",
"url": "https://files.pythonhosted.org/packages/81/f0/3c6a2289fa1c649b61083d99a5182895f19619c239e3bb97ba9529dba59d/claude_code_indexer-1.29.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-12 14:28:29",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "tuannx",
"github_project": "claude-prompts",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "claude-code-indexer"
}
JSON
