FarhanAliRaza代码搜索-项目模板
此模板存储库提供 100%本地语义代码搜索 使用 FarhanAliRaza/claude当地背景 对于任何项目。
✨ 所得
- 🔍 语义代码搜索：按含义查找代码，而不仅仅是关键字
- 🔒 100%私人：没有云API，你的代码永远不会离开你的机器
- 💰 零成本：不收取API费用，完全免费
- ⚡ 快速：本地FAISS矢量搜索
- 🎯 每个项目：每个项目的独立索引
- 🌐 多语言：Python、JS/TS、Go、Rust、Java、C/C++、C#、Markdown
🚀 快速开始
对于新项目
- 将此模板用于新项目
git clone your-project
cd your-project- 在全球范围内安装FarhanAliRaza （一次性，约1分钟）
curl -fsSL https://raw.githubusercontent.com/FarhanAliRaza/claude-context-local/main/scripts/install.sh | bash- 启用克劳德代码MCP批准 （关键-MCP加载所需）
创建或编辑 .claude/settings.local.json 在您的项目中：
mkdir -p .claude
cat > .claude/settings.local.json > your-project/.gitignore- 使包装器可执行
chmod +x your-project/.mcp-server-wrapper.sh- 启用克劳德代码MCP批准 （关键）
创建或编辑 .claude/settings.local.json 在您的项目中：
cd your-project
mkdir -p .claude
cat > .claude/settings.local.json Index this codebase
Expected output:
✅ Indexing /path/to/project...
✅ Found 121 files
✅ Created 1804 code chunks
✅ Indexed in 23 seconds语义搜索
> Find all HTTP request handling code
Returns code chunks that handle HTTP requests,
even if they don't contain the exact words "HTTP request"!类别/功能搜索
> Show me the DatabaseConnection class
Returns:
1. database/connection.py:15-45 (class DatabaseConnection) ⭐ EXACT
2. database/pool.py:20-40 (ConnectionPool)
3. database/manager.py:10-30 (DBConnectionManager)特征搜索
> Find error handling patterns
Returns all error handling code across your codebase,
understanding the semantic meaning of "error handling"检查状态
> What's the indexing status?
Returns:
{
"total_chunks": 1804,
"files_indexed": 121,
"top_folders": { "src": 450, "tests": 610 }
}🔧 运作原理
┌─────────────────────────────────────────────────┐
│ Your Project │
│ ├── .mcp.json ← Claude Code reads │
│ ├── .mcp-server-wrapper.sh ← Launches server │
│ ├── .claude/ │
│ │ └── settings.local.json ← Enables MCP │
│ └── .code-search-index/ ← Local FAISS index │
└─────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────┐
│ ~/.local/share/claude-context-local/ │
│ ├── mcp_server/ ← MCP server code │
│ ├── embeddings/ ← EmbeddingGemma model │
│ └── chunking/ ← AST-based parser │
└─────────────────────────────────────────────────┘要点：
- FarhanAliRaza在全球范围内安装过一次
~/.local/share/ - 每个项目都有自己的独立索引
.code-search-index/ - Claude代码批准通过
.claude/settings.local.json必需的 - 项目之间没有冲突
- 可以随时安全地删除和重新生成索引
🛠️ 故障排除
重新启动后MCP服务器未加载
症状：没有 mcp__code-search__* 重启后可用的工具
原因：缺少克劳德代码审批设置
修复:
- 创建或编辑
.claude/settings.local.json在项目根目录中：
mkdir -p .claude
cat > .claude/settings.local.json << 'EOF'
{
"enableAllProjectMcpServers": true
}
EOF- 重新启动Claude代码
验证修复:
# Check if approval setting exists
cat .claude/settings.local.json | grep enableAllProjectMcpServers
# Should output: "enableAllProjectMcpServers": true附加检查表:
- ✅ 是
.mcp.json在项目根中？ls .mcp.json - ✅ 包装器是否可执行？
ls -la .mcp-server-wrapper.sh（应显示rwx) - ✅ 是否存在全局安装？
ls ~/.local/share/claude-context-local/ - ✅ 是否启用审批？
grep enableAllProjectMcpServers .claude/settings.local.json
“未找到claude上下文本地”
修复：
curl -fsSL https://raw.githubusercontent.com/FarhanAliRaza/claude-context-local/main/scripts/install.sh | bash“未找到uv命令”
修复：
curl -LsSf https://astral.sh/uv/install.sh | sh
# Restart terminal包装脚本权限被拒绝
修复：
chmod +x .mcp-server-wrapper.sh从头开始重新索引
# Delete index:
rm -rf .code-search-index/
# Re-index in Claude Code:
"Index this codebase"索引未建立/搜索未返回任何结果
清单:
- ✅ 索引是否成功完成？
- ✅ 查看索引统计数据：“索引状态如何？”
- ✅ 验证中的文件
.code-search-index/projects/*/index/
修复:
# Re-index from scratch
rm -rf .code-search-index/
# Then in Claude Code: "Index this codebase"📊 演出
| 项目大小 | 文件 | 索引时间 | 存储 |
|---|---|---|---|
| 小 | \<100 | 10-20秒 | ~5 MB |
| 中等 | 1000 | 1-2分钟 | ~50 MB |
| 大 | 10000 | 10-15分钟 | ~500 MB |
搜索速度： 每次查询50-200ms
🌟 为什么选择FarhanAliRaza？
我们进行了测试 3个本地代码搜索实现只有FarhanAliRaza工作可靠：
| 实施 | 状态 | 问题 |
|---|---|---|
| 丹尼尔/克劳德语境mcp | ❌ 状态跟踪错误（GitHub#226） | |
| MikeO AI/claude上下文本地mcp | ❌ 破碎 | 100块硬限制 |
| FarhanAliRaza/claude当地背景 | ✅ 工作 | 未找到 |
测试方法： 121个文件，1804个块，生产就绪
📚 建筑
- 嵌入： 谷歌嵌入Gemma（768维）
- 矢量数据库： FAISS（IndexFlatIP）
- Chunking： 基于AST（尊重代码结构）
- 语言： Python、JS/TS、Go、Rust、Java、C/C++、C#、Markdown
- 储存： 项目本地
.code-search-index/
🤝 贡献
发现此模板有用吗？考虑：
- ⭐ 主演原版 FarhanAliRaza/claude当地背景
- 📝 通过pull请求改进此模板
- 🐛 报告您遇到的问题
📄 许可证
此模板配置按原样提供。
FarhanAliRaza/claude context local有自己的许可证-请参阅他们的存储库。
🔗 资源
- FarhanAliRaza知识库
- 安装指南 -详细说明
- 设置检查表 -逐步验证
- 比较 -我们为什么选择FarhanAliRaza
______________________________________________________________________
最后更新时间： 2025-11-27 状态： ✅ 生产准备就绪 测试时间： lmstudio桥接增强（1804块，121个文件）