🧠 Codebase Curator

MCP开发工具

提供方 RLabs-Inc

开发工具 stdio · 本地进程 OAuth 授权 社区 / 第三方 ClaudeCursorCodexZed
查看接入方式

A set of tools to use while coding using the Claude code cli. "smartgrep" is a grep-like tool that uses a semantic index of the codebase to provide Claudes with information tailored for how they think. Claudes love it! A "codebase-curator" Claude to assist the "developer" Claude

一句话选型结论

按资料字段整理

🧠 Codebase Curator 属于开发工具类 MCP 服务器,stdio · 本地进程,OAuth 授权,可直接接入 Claude、Cursor、Codex 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式本地部署
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

aimcpgrep

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
bun run /path/to/codebase-curator/src/mcp-servers/codebase-curator/server.ts

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 node,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude、Cursor、Codex,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
🧠 Codebase Curator当前 未标注 stdio · 本地进程 本地部署 有 未标注
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方RLabs-Inc上游标注的维护方 RLabs-Inc
分类开发工具本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · node本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验未标注上游最后核验时间

详细介绍

12.8 KB
来自项目仓库与上游目录的原文,未做删改

🧠 Codebase Curator

> 🎁 Give your Claude the gift of deep codebase understanding
>
> Because your Claude deserves a codebase expert by its side

What is Codebase Curator?

Codebase Curator transforms how Claude understands your code. Instead of treating each question as isolated, it gives Claude a persistent, intelligent companion that deeply understands your entire codebase.

The Problem

When you ask Claude about your codebase, it starts from scratch every time:

  • 🔄 Repetitive exploration of the same files
  • ⏰ Slow responses as it re-discovers your architecture
  • 🎯 Inconsistent understanding between questions
  • 😕 Generic suggestions that don't fit your patterns

The Solution: Two-Claude Architecture

Codebase Curator spawns a dedicated "Curator Claude" that becomes an expert on YOUR specific codebase:```
You (Coding Claude) → "How do I add authentication?"
↓
Codebase Curator → Spawns Curator Claude
↓
Curator Claude → Deeply analyzes your codebase
↓
You get → Specific guidance that fits YOUR patterns


## ✨ Key Features

### 🤖 Two-Claude Architecture
- **Curator Claude**: A dedicated AI that becomes an expert on YOUR codebase
- **Persistent Sessions**: Remembers context between questions
- **Instant Follow-ups**: First question takes 2 minutes, rest are instant

### 🔍 Smart Grep - Semantic Search That Understands Code

#### 🚀 NEW: Compact Mode for Claudes (90% Less Context Usage!)

Smart Grep now defaults to a **compact summary mode** that's optimized for AI assistants:```bash
# Default: Compact summary (perfect for Claudes)
smartgrep "authService"

══════════════════════════════════════════════════════════════════════
🔍 SMARTGREP: "authService" (17 results in 4 files)

📍 DEFINITION: auth/service.ts:42 (CLASS)
   export class AuthService {
   constructor(db: Database, cache: Cache)

🔥 TOP USAGE:
   • api/routes.ts:
     - Line 15: authService.authenticate(username, password)
     - Line 23: authService.validateToken(token)
   • middleware/auth.ts:12 - if (!authService.isValid(token))

⚡ BREAKING CHANGES (if you modify this):
   • LoginController.handleLogin() - calls authenticate()
   • AuthMiddleware.verify() - calls validateToken()

💡 PATTERNS DETECTED:
   • Always async/await calls
   • Throws: AuthenticationError, TokenExpiredError

🎯 NEXT: smartgrep refs "authService" | smartgrep "authenticate"
══════════════════════════════════════════════════════════════════════

# Need full details? Use --full flag
smartgrep "authService" --full    # Complete analysis with all matches

Why This Matters for Claudes:
- Before: Each search consumed 2000-3000 tokens
- Now: Only 200-300 tokens per search
- Result: 10x more searches before hitting context limits!

Core Features```bash

Don't just search - understand!

smartgrep "handleAuth" # Shows where it's used + usage count
smartgrep refs "apiClient" # Full impact analysis - see all references
smartgrep group auth # Search ALL auth patterns at once
smartgrep changes # Analyze your uncommitted changes impact
smartgrep changes --compact # Quick risk assessment before committing
smartgrep "func NewAuth" # Go functions
smartgrep "impl Auth" # Rust implementations
smartgrep "protocol Auth" # Swift protocols
smartgrep "function deploy" # Shell scripts

Returns organized results with usage counts:

→ Functions: authenticate() (12 uses), validateUser() (5 uses)

→ Classes: AuthService, AuthMiddleware

→ Config: JWT_SECRET, AUTH_URL, oauth settings

→ Cross-references: Shows actual calling code with file:line locations

Advanced patterns

smartgrep "error&handler" # AND search
smartgrep "login|signin|auth" # OR search
smartgrep "!test" --type function # Exclude tests

Custom concept groups for your project

smartgrep group add payments charge,bill,invoice,transaction
smartgrep group payments --type function # Search your custom group


### 🌐 Language Support - Now 14 Languages + Frameworks!

**Programming Languages:**
- **TypeScript/JavaScript** - Full AST parsing, JSX/TSX, ES6+, decorators
- **Python** - Classes, decorators, async, type hints, docstrings, dataclasses
- **Go** - Interfaces, goroutines, channels, embedded types, generics
- **Rust** - Traits, macros, lifetimes, async, unsafe blocks, derive
- **Swift** - Protocols, SwiftUI, extensions, property wrappers, actors
- **Shell** - Functions, aliases, exports, heredocs, arrays

**Framework Files (NEW!):**
- **Svelte** (.svelte) - Runes ($state, $derived), stores, lifecycle hooks, directives
- **Vue** (.vue) - Composition API, SFC, directives (v-if, v-for), defineProps
- **Astro** (.astro) - Props interface, client directives, Astro.props
- **MDX** (.mdx) - Markdown with JSX components, imports, exports

**Configuration Files:**
- **JSON** - package.json, tsconfig.json, hierarchical parsing
- **YAML** - CI/CD pipelines, Docker Compose, Kubernetes manifests
- **TOML** - Cargo.toml, pyproject.toml, structured configs
- **Environment** - .env files with secure value masking

### 🎯 Live Monitoring Dashboard```bash
# Watch your codebase evolve in real-time
bun run monitor watch --overview

# See:
# → Live code distribution by type
# → File changes as they happen
# → Most complex files by declaration count
# → Automatic reindexing on changes

🧠 Persistent Understanding

  • First question: Curator Claude explores and learns your codebase
  • Every question after: Builds on that understanding
  • Result: Faster, more accurate, context-aware responses

🚀 Real Examples```bash

Overview - The foundation (takes ~2 minutes)

"Give me an overview of this codebase"
→ Curator explores everything, understands patterns

Follow-up questions are instant and accurate

"How does authentication work?"
→ Immediate response with YOUR specific implementation

"Where should I add a payment feature?"
→ Knows your patterns, suggests the right location


## 📦 Installation

### Prerequisites

- Claude Code with active subscription
- Bun runtime (faster than Node.js)

### Quick Start

1. **Clone and install globally**```bash
git clone https://github.com/RLabs-Inc/codebase-curator.git
cd codebase-curator
bun install
bun link  # Makes commands available globally

Now you can use these commands from anywhere:
- smartgrep - Semantic code search
- curator-monitor - Live monitoring
- codebase-curator - Interactive CLI

📚 Full Installation Guide - Detailed instructions and troubleshooting

  1. Configure Claude Code MCP
    Add to your claude_code_config.json:```json
    {
    "mcpServers": {
    "codebase-curator": {
    "command": "bun",
    "args": ["run", "/path/to/codebase-curator/src/mcp-servers/codebase-curator/server.ts"]
    }
    }
    }

3. **Restart Claude Code**
   The Codebase Curator tools will appear in Claude's tool panel.

## 🎯 Usage

### In Claude Code

1. **Set your project**```
Use the set_project_path tool:
Path: /path/to/your/project
  1. Get an overview (do this first!)```
    Use the get_codebase_overview tool

3. **Ask questions**```
Use ask_curator: "How does the payment system work?"
Use add_new_feature: "Add user notifications"
Use implement_change: "Fix the login timeout bug"

Smart Grep CLI - Semantic Search Made Simple```bash

After installation with bun link, use from anywhere:

Concept groups - search semantic patterns

smartgrep group auth # ALL auth patterns (login, jwt, token...)
smartgrep group error # ALL error patterns (exception, fail...)
smartgrep group api # ALL API patterns (endpoint, route...)
smartgrep group list # See all 20+ concept groups

NEW: Analyze your changes before committing!

smartgrep changes # Full impact analysis of uncommitted changes
smartgrep changes --compact # Quick risk assessment (one line)

Advanced search patterns

smartgrep "user|auth" # OR search
smartgrep "async&function" # AND search
smartgrep "!test" --type function # Exclude tests
smartgrep refs "PaymentService" # Find all usages

Custom groups for your project

smartgrep group add payments charge,bill,invoice,transaction
smartgrep group payments # Use your custom group

Type filters for precision

smartgrep "auth" --type function # Only functions
smartgrep "error" --type string # Only string literals
smartgrep group api --type class # Only API classes

Sort and format options

smartgrep group service --sort usage # Most used first
smartgrep "user" --compact # One line per result
smartgrep "api" --json # Machine-readable output


## 🏗️ Architecture

### Monorepo Structure```
src/
├── packages/               # Distributable packages
│   ├── semantic-core/      # Core indexing engine
│   ├── smartgrep/          # Semantic search CLI
│   └── codebase-curator/   # Full suite
├── services/               # Shared business logic
├── tools/                  # CLI interfaces
├── mcp-servers/            # AI interfaces
└── shared/                 # Common utilities

Two-Claude System

  • Coding Claude: You, working in Claude Code
  • Curator Claude: Your dedicated codebase expert
  • Communication: Via MCP (Model Context Protocol)

Smart Components

  • Session Persistence: Maintains context between questions with --resume
  • Dynamic Timeouts: Adapts to different operations (Task: 10min, Bash: 5min)
  • Semantic Indexing: Understands code structure with 20+ concept groups
  • Incremental Indexing: Only reprocesses changed files with debouncing
  • Live Monitoring: Real-time dashboard shows code evolution as you work
  • Cross-References: Shows not just where code is defined, but who uses it
  • Streaming Architecture: Handles massive codebases efficiently
  • Package Distribution: Each tool can be installed independently

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Development```bash

Install workspace dependencies

bun install

Run tests

bun test

Run MCP server locally

bun run mcp

Run CLI tools

bun run start # Curator CLI
bun run smartgrep [query] # Smart grep
bun run monitor watch --overview # Live monitoring

Build semantic index

bun run smartgrep --index

Analyze your changes

bun run smartgrep changes # Full impact analysis
bun run smartgrep changes -c # Quick risk check

Work with packages

cd src/packages/smartgrep
bun run build # Build for distribution
bun run build:binary # Create standalone binary
```

MCP Tools Available

  • get_codebase_overview - Deep analysis of your codebase
  • ask_curator - Ask questions about the code
  • add_new_feature - Get guidance for new features
  • implement_change - Get help with specific changes
  • list_project_special_tools - Discover AI-optimized tools
  • remind_about_smartgrep - Get smart-grep usage examples

📄 License

MIT - see LICENSE

🙏 Acknowledgments

Built with ❤️ by RLabs Inc. and Claude

Special thanks to the Claude Code team for making this integration possible.


Remember: Your Claude works hard to help you code. Give it the superpower it deserves! 🚀

📚 Documentation

  • Installation Guide - Detailed setup instructions
  • Language Support - All 10 supported languages
  • Smart Grep Guide - Advanced search techniques
  • Architecture Overview - How it all works
  • Troubleshooting - Common issues and solutions
  • Release Notes v4.0 - Latest updates

🎆 What's New

v4.0 - Git Impact Analysis & Custom Groups

  • Git Changes Analysis: smartgrep changes analyzes uncommitted changes impact
  • Custom Concept Groups: Create project-specific semantic patterns
  • Performance: 37x faster than standalone tools (1s vs 37.5s)
  • Risk Assessment: One-line safety check before committing
  • 10 Language Support: Added Swift and Shell script support

v3.0 - Smart Grep Revolution

  • Concept Groups: smartgrep group auth searches semantic patterns
  • Advanced Search: AND/OR/NOT patterns, regex support
  • Type Filters: Search only functions, classes, variables, etc.
  • Live Monitoring: Real-time codebase overview dashboard
  • MCP Discovery: Tools help Claudes discover smart-grep features

v2.3 - Incremental Indexing

  • Hash Tree: Bun.hash() for instant file change detection
  • Smart Debouncing: Handles duplicate save events gracefully
  • Silent Mode: Clean output for live monitoring
  • Unique File Tracking: Shows real changes, not event counts

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
🧠 Codebase Curator 怎么安装?

在客户端按下面的安装命令接入:bun run /path/to/codebase-curator/src/mcp-servers/codebase-curator/server.ts。装完在客户端配置里引用同一个包或端点。

🧠 Codebase Curator 怎么在 Claude、Cursor、Codex 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

🧠 Codebase Curator 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

🧠 Codebase Curator 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

🧠 Codebase Curator 支持哪些客户端?

资料标注支持 Claude、Cursor、Codex、Zed;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

🧠 Codebase Curator 能提供哪些能力?

资料显示能力标签包括 ai、mcp、grep、ai agents、claude、ai assistant。具体工具清单以官方文档为准。

🧠 Codebase Curator 需要什么运行环境?

运行时为 node;属于本地进程,需要在本机装好运行环境。

🧠 Codebase Curator 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 未标注。