Farhan Code Search Template

FarhanAliRaza代码搜索-项目模板

此模板存储库提供 100%本地语义代码搜索 使用 FarhanAliRaza/claude当地背景 对于任何项目。

✨ 所得

• 🔍 语义代码搜索：按含义查找代码，而不仅仅是关键字
• 🔒 100%私人：没有云API，你的代码永远不会离开你的机器
• 💰 零成本：不收取API费用，完全免费
• ⚡ 快速：本地FAISS矢量搜索
• 🎯 每个项目：每个项目的独立索引
• 🌐 多语言：Python、JS/TS、Go、Rust、Java、C/C++、C#、Markdown

🚀 快速开始

对于新项目

1. 将此模板用于新项目

   git clone  your-project
   cd your-project

1. 在全球范围内安装FarhanAliRaza （一次性，约1分钟）

   curl -fsSL https://raw.githubusercontent.com/FarhanAliRaza/claude-context-local/main/scripts/install.sh | bash

1. 启用克劳德代码MCP批准 （关键-MCP加载所需）

创建或编辑 .claude/settings.local.json 在您的项目中：

   mkdir -p .claude
   cat > .claude/settings.local.json > your-project/.gitignore

1. 使包装器可执行

   chmod +x your-project/.mcp-server-wrapper.sh

1. 启用克劳德代码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__* 重启后可用的工具

原因：缺少克劳德代码审批设置

修复:

1. 创建或编辑 .claude/settings.local.json 在项目根目录中：

   mkdir -p .claude
   cat > .claude/settings.local.json << 'EOF'
   {
     "enableAllProjectMcpServers": true
   }
   EOF

1. 重新启动Claude代码

验证修复:

# Check if approval setting exists
cat .claude/settings.local.json | grep enableAllProjectMcpServers
# Should output: "enableAllProjectMcpServers": true

附加检查表:

1. ✅ 是 .mcp.json 在项目根中？ ls .mcp.json
2. ✅ 包装器是否可执行？ ls -la .mcp-server-wrapper.sh （应显示 rwx)
3. ✅ 是否存在全局安装？ ls ~/.local/share/claude-context-local/
4. ✅ 是否启用审批？ 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"

索引未建立/搜索未返回任何结果

清单:

1. ✅ 索引是否成功完成？
2. ✅ 查看索引统计数据：“索引状态如何？”
3. ✅ 验证中的文件 .code-search-index/projects/*/index/

修复:

# Re-index from scratch
rm -rf .code-search-index/
# Then in Claude Code: "Index this codebase"

📊 演出

搜索速度： 每次查询50-200ms

🌟 为什么选择FarhanAliRaza？

我们进行了测试 3个本地代码搜索实现只有FarhanAliRaza工作可靠：

测试方法： 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个文件）