Tearags MCP
T

Tearags MCP

TeaRAGs is a semantic code search MCP server designed for coding agents. It supports large - scale codebases through AST - aware chunking and incremental indexing, and uses Git trajectories (such as 19 signals including code changes, author information, and defect repair rates) for intelligent re - ranking, surpassing traditional embedding similarity retrieval.
2.5 points
6.3K

What is TeaRAGs?

TeaRAGs is an intelligent assistant specifically designed for code search. Different from traditional code search tools, it can not only understand the semantic meaning of code but also analyze the evolution history of code. This means that when you search for code, it can not only find code with similar functions but also tell you which code is more stable, which authors are more familiar with the relevant field, and which code has a lower risk of modification.

How to use TeaRAGs?

TeaRAGs is integrated and used through AI assistants such as Claude. First, configure the server, and then issue search instructions through the AI assistant. You can let the AI assistant index the entire codebase and then ask questions like 'Find the code for handling user authentication' or 'Show the API endpoints that have been modified frequently recently'. The system will automatically analyze the code semantics and evolution history and return the most relevant results.

Applicable scenarios

1. When new developers are getting familiar with the codebase, quickly find relevant code examples. 2. When refactoring code, identify stable and reliable code templates. 3. When fixing bugs, find solutions to similar problems. 4. During code review, understand the historical modification situation of the code. 5. When assessing technical debt, identify high - risk code areas.

Main features

Evolution trajectory analysis
Analyze the git history of the code, track 19 evolution signals such as the modification frequency of each function, author changes, and bug repair records to help understand the stability and reliability of the code.
Intelligent semantic search
Search based on the semantic meaning of the code, and can understand the actual functions of functions, classes, and variables, rather than just keyword matching.
AST intelligent chunking
Use the abstract syntax tree (AST) to intelligently split the code into meaningful blocks (such as functions and classes) to ensure the integrity of the search results.
Intelligent result re - ranking
Provide a variety of preset re - ranking strategies: hotspots, code ownership, tech debt, security audit, etc., to optimize the results according to different scenarios.
Multi - model support
Support local models (Ollama) and cloud models (OpenAI, Cohere, Voyage), and users can flexibly choose according to their needs.
Incremental indexing
Support incremental updates of large - scale codebases, only index the changed parts, and improve efficiency.
Advantages
Intelligently understand the code evolution history and provide more reliable search results
Support local deployment to protect code privacy and security
Seamlessly integrate with mainstream AI assistants (Claude) for easy use
Open - source and free, with customizable and extensible functions
Strong ability to handle large - scale codebases, supporting millions of lines of code
Limitations
Requires configuration and deployment, which has a certain threshold for non - technical users
It takes a long time to index a large codebase for the first time
Relies on git history data, and the effect is limited for newly created projects
Requires a certain amount of computing resources (CPU/memory)
Currently mainly supports common programming languages

How to use

Environment preparation
Install the necessary software: Node.js, Docker/Podman, Git. Ensure that the system has enough memory and storage space.
Download and install
Clone the project repository and install the dependency packages.
Start the service
Use Docker Compose to start the necessary database and model services.
Configure the AI assistant
Add the TeaRAGs server to AI assistants such as Claude Code.
Start using
Send instructions through the AI assistant to index and search for code.

Usage examples

Case 1: New developers getting familiar with the codebase
New developers joining the team need to quickly understand the implementation of the user authentication module.
Case 2: Refactoring technical debt
The team needs to identify and refactor high - risk code areas.
Case 3: Code review assistance
Understand the historical background of the code being reviewed during code review.
Case 4: Looking for code templates
Need to implement a new REST API endpoint and look for existing best practices as a reference.

Frequently Asked Questions

What's the difference between TeaRAGs and ordinary code search tools?
Do I need programming experience to use it?
Which programming languages are supported?
Is my code data safe?
How long does it take to index a large codebase?
Can I use it for projects without git history?

Related resources

Full documentation
Detailed installation guide, configuration instructions, advanced functions, and usage tips
GitHub repository
Source code, issue feedback, contribution guidelines
Quick start guide
15 - minute quick start guide
Architecture design
System architecture and technical implementation details
Community discussion
User discussions, experience sharing, and function suggestions

Installation

Copy the following command to your Client for configuration
Note: Your key is sensitive information, do not share it with anyone.

Alternatives

A
Airweave
Airweave is an open - source context retrieval layer for AI agents and RAG systems. It connects and synchronizes data from various applications, tools, and databases, and provides relevant, real - time, multi - source contextual information to AI agents through a unified search interface.
Python
6.0K
5 points
V
Vestige
Vestige is an AI memory engine based on cognitive science. By implementing 29 neuroscience modules such as prediction error gating, FSRS - 6 spaced repetition, and memory dreaming, it provides long - term memory capabilities for AI. It includes a 3D visualization dashboard and 21 MCP tools, runs completely locally, and does not require the cloud.
Rust
4.5K
4.5 points
B
Better Icons
An MCP server and CLI tool that provides search and retrieval of over 200,000 icons, supports more than 150 icon libraries, and helps AI assistants and developers quickly obtain and use icons.
TypeScript
6.7K
4.5 points
A
Assistant Ui
assistant - ui is an open - source TypeScript/React library for quickly building production - grade AI chat interfaces, providing composable UI components, streaming responses, accessibility, etc., and supporting multiple AI backends and models.
TypeScript
7.3K
5 points
A
Apify MCP Server
The Apify MCP Server is a tool based on the Model Context Protocol (MCP) that allows AI assistants to extract data from websites such as social media, search engines, and e-commerce through thousands of ready-to-use crawlers, scrapers, and automation tools (Apify Actors). It supports OAuth and Skyfire proxy payment and can be integrated into MCP clients such as Claude and VS Code through HTTPS endpoints or local stdio.
TypeScript
6.5K
5 points
R
Rsdoctor
Rsdoctor is a build analysis tool specifically designed for the Rspack ecosystem, fully compatible with webpack. It provides visual build analysis, multi - dimensional performance diagnosis, and intelligent optimization suggestions to help developers improve build efficiency and engineering quality.
TypeScript
9.4K
5 points
N
Next Devtools MCP
The Next.js development tools MCP server provides Next.js development tools and utilities for AI programming assistants such as Claude and Cursor, including runtime diagnostics, development automation, and document access functions.
TypeScript
10.8K
5 points
T
Testkube
Testkube is a test orchestration and execution framework for cloud-native applications, providing a unified platform to define, run, and analyze tests. It supports existing testing tools and Kubernetes infrastructure.
Go
6.5K
5 points
G
Gitlab MCP Server
Certified
The GitLab MCP server is a project based on the Model Context Protocol that provides a comprehensive toolset for interacting with GitLab accounts, including code review, merge request management, CI/CD configuration, and other functions.
TypeScript
24.4K
4.3 points
N
Notion Api MCP
Certified
A Python-based MCP Server that provides advanced to-do list management and content organization functions through the Notion API, enabling seamless integration between AI models and Notion.
Python
20.4K
4.5 points
M
Markdownify MCP
Markdownify is a multi-functional file conversion service that supports converting multiple formats such as PDFs, images, audio, and web page content into Markdown format.
TypeScript
35.3K
5 points
D
Duckduckgo MCP Server
Certified
The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.
Python
72.5K
4.3 points
U
Unity
Certified
UnityMCP is a Unity editor plugin that implements the Model Context Protocol (MCP), providing seamless integration between Unity and AI assistants, including real - time state monitoring, remote command execution, and log functions.
C#
31.1K
5 points
F
Figma Context MCP
Framelink Figma MCP Server is a server that provides access to Figma design data for AI programming tools (such as Cursor). By simplifying the Figma API response, it helps AI more accurately achieve one - click conversion from design to code.
TypeScript
64.4K
4.5 points
G
Gmail MCP Server
A Gmail automatic authentication MCP server designed for Claude Desktop, supporting Gmail management through natural language interaction, including complete functions such as sending emails, label management, and batch operations.
TypeScript
21.0K
4.5 points
C
Context7
Context7 MCP is a service that provides real-time, version-specific documentation and code examples for AI programming assistants. It is directly integrated into prompts through the Model Context Protocol to solve the problem of LLMs using outdated information.
TypeScript
96.8K
4.7 points
AIBase
Zhiqi Future, Your AI Solution Think Tank
© 2026AIBase