STARWARCLOUD STARWAR.AI
返回市场
大数据解析

大数据解析

作者：agentbrazley17 星标更新：2025-06-27
安装使用来源：spider==github.com

项目介绍

BigParse 🚀

一个MCP（模型上下文协议）服务器，使Claude和其他大型语言模型能够即时、智能地访问您的代码库。可以将其视为“给您的大型语言模型提供了一个代码GPS”——无需逐行阅读每个文件，BigParse让大型语言模型能够高效地导航和搜索您的代码库。

为什么选择BigParse？

遇到的问题

没有BigParse时，当您询问Claude关于您的代码：

  • 您需要手动粘贴文件（占用大量上下文）
  • Claude必须从头开始解析所有内容
  • 受限于上下文窗口内的内容
  • 没有办法跨大型代码库进行搜索

解决方案

有了BigParse，Claude可以：

  • 即刻搜索整个代码库
  • 导航到确切的文件位置和行号
  • 在不读取每个文件的情况下理解代码结构
  • 处理任何大小的代码库

特性 ✨

  • ⚡ 雷电般的代码搜索 - 使用正则表达式在毫秒内搜索整个代码库
  • 🔍 智能符号提取 - 使用语言服务器协议提取类、函数、接口
  • 💾 智能缓存 - 智能缓存使得重新索引速度提高1000倍以上
  • 🌐 多语言支持 - 支持TypeScript、JavaScript、Python、Rust、Go、Dart/Flutter等
  • 🔒 安全子进程处理 - 通过命令验证安全安装语言服务器
  • 🤖 MCP集成 - 无缝与Claude Desktop和Claude Code集成
  • 📊 性能指标 - 精确查看BigParse的工作速度

安装

方案1：Claude Desktop（自动更新）

  1. 添加到Claude Desktop配置中：

    # macOS
open ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Windows
notepad %APPDATA%\Claude\claude_desktop_config.json

# Linux
nano ~/.config/Claude/claude_desktop_config.json

  2. 将BigParse添加到mcpServers部分：

    {
  "mcpServers": {
    "BigParse": {
      "command": "npx",
      "args": ["bigparse"],
      "env": {
        "WORKSPACE_ROOT": "/path/to/your/projects"
      }
    }
  }
}

  3. 将/path/to/your/projects替换为您想要分析的目录

  4. 重启Claude Desktop

优点：

  • ✅ 始终运行最新版本
  • ✅ 不需要安装
  • ✅ 无需手动更新
  • ✅ 所有平台通用

方案2：Claude Code CLI

先决条件

  • Node.js 16+
  • npm 或 yarn

快速开始

  1. 克隆仓库：
git clone https://github.com/agentbrazley/BigParse.git
cd BigParse
  1. 安装依赖：
npm install
  1. 构建项目：
npm run build
  1. 为Claude Code安装：
./scripts/install-for-claude.sh

或者手动：

claude mcp add bigparse "node" "$(pwd)/dist/index.js"

语言服务器支持

为了增强功能，请安装语言服务器：

# TypeScript/JavaScript
npm install -g typescript-language-server typescript

# Python
pip install python-lsp-server

# Rust
rustup component add rust-analyzer

# Go
go install golang.org/x/tools/gopls@latest

# Dart/Flutter
# 包含在Flutter SDK中

工作原理

BigParse创建一个可搜索的代码库索引，大型语言模型可以高效查询：

  1. 索引：扫描您的代码库并提取符号，创建一个可搜索的地图
  2. 缓存：存储结果以供后续查询即时访问
  3. 搜索：使用优化的正则表达式搜索，并带有文件类型过滤
  4. LSP集成：利用语言服务器进行准确的符号提取

性能示例

没有BigParse：

  • Claude：“请分享您的WebSocket文件”
  • 您：粘贴多个大文件
  • 上下文使用量：5000+个token

有了BigParse：

  • Claude：搜索“WebSocket”
  • 即时结果，带有确切位置
  • 上下文使用量：约50个token

使用方法

一旦安装完成，BigParse工具将在Claude中自动可用。只需询问：

  • “搜索这个项目中的所有React组件”
  • “找到WebSocket处理器定义的位置”
  • “显示所有TypeScript接口”
  • “这个代码库的结构是什么？”

设置工作区

Claude Desktop

要更改工作区目录，请编辑您的Claude Desktop配置文件并更新WORKSPACE_ROOT环境变量：

{
  "mcpServers": {
    "BigParse": {
      "command": "node",
      "args": ["/path/to/BigParse/dist/index.js"],
      "env": {
        "WORKSPACE_ROOT": "/new/project/path"
      }
    }
  }
}

然后重启Claude Desktop。

Claude Code CLI

默认情况下，BigParse使用当前目录。要分析特定项目：

# 使用辅助脚本
./scripts/update-workspace.sh /path/to/your/project

# 或使用环境变量
claude mcp remove bigparse -s local
claude mcp add bigparse "node" "/path/to/BigParse/dist/index.js" --env "WORKSPACE_ROOT=/path/to/project"

可用工具

| 工具 | 描述 | 示例 | |------|-------------|---------|| | index_codebase | 对项目文件进行索引以便搜索 | "索引这个TypeScript项目" | | search_code | 使用正则表达式模式搜索 | "查找所有异步函数" | | get_symbols | 从文件中提取符号 | "显示main.ts中的符号" | | find_references | 查找符号的所有引用 | "查找WebSocketClient的所有用法" | | go_to_definition | 跳转到符号定义 | "跳转到handleMessage的定义" | | check_language_servers | 检查已安装的语言服务器 | "哪些语言服务器已安装？" | | install_language_server | 安装语言服务器 | "安装TypeScript语言服务器" |

配置

支持的语言

  • TypeScript/JavaScript（.ts, .tsx, .js, .jsx）
  • Python（.py）
  • Rust（.rs）
  • Go（.go）
  • Java（.java）
  • C#（.cs）
  • C/C++（.c, .cpp, .h）
  • Ruby（.rb）
  • PHP（.php）
  • Swift（.swift）
  • Dart（.dart）

缓存位置

BigParse在其项目目录下的.bigparse/中存储缓存。请将其添加到.gitignore中：

.bigparse/

开发

从源码构建

# 安装依赖
npm install

# 构建TypeScript
npm run build

# 运行测试
npm test

项目结构

BigParse/
├── src/                    # TypeScript源文件
│   ├── index.ts           # MCP服务器入口点
│   ├── lsp/               # 语言服务器协议集成
│   ├── indexing/          # 代码索引和缓存
│   ├── tools/             # MCP工具定义
│   └── subprocess/        # 安全子进程处理
├── dist/                  # 编译后的JavaScript
├── config/                # 语言配置
└── scripts/               # 辅助脚本

贡献

我们欢迎贡献！请参阅CONTRIBUTING.md获取指南。

安全

BigParse包含安全特性以安全处理子进程命令：

  • 语言服务器安装的命令白名单
  • 模式检测以防止命令注入
  • 验证所有子进程操作

故障排除

BigParse未显示在Claude中

# 检查是否已安装
claude mcp list

# 如需重新安装
./install-for-claude.sh

语言服务器无法正常工作

# 检查已安装的服务器
claude mcp get bigparse
# 然后请求Claude使用check_language_servers工具

缓存问题

# 清除缓存
rm -rf .bigparse/

许可证

MIT许可证 - 请参阅LICENSE文件

致谢

由Lancio AI（2025）创建

支持

为Claude社区制作 ❤️