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
7.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
15.2K
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
10.5K
4.5 points
M
Moltbrain
MoltBrain is a long-term memory layer plugin designed for OpenClaw, MoltBook, and Claude Code, capable of automatically learning and recalling project context, providing intelligent search, observation recording, analysis statistics, and persistent storage functions.
TypeScript
10.1K
4.5 points
B
Bm.md
A feature-rich Markdown typesetting tool that supports multiple style themes and platform adaptation, providing real-time editing preview, image export, and API integration capabilities
TypeScript
14.9K
5 points
S
Security Detections MCP
Security Detections MCP is a server based on the Model Context Protocol that allows LLMs to query a unified security detection rule database covering Sigma, Splunk ESCU, Elastic, and KQL formats. The latest version 3.0 is upgraded to an autonomous detection engineering platform that can automatically extract TTPs from threat intelligence, analyze coverage gaps, generate SIEM-native format detection rules, run tests, and verify. The project includes over 71 tools, 11 pre-built workflow prompts, and a knowledge graph system, supporting multiple SIEM platforms.
TypeScript
6.7K
4 points
P
Paperbanana
Python
8.9K
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
8.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
10.0K
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
80.3K
4.3 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
28.5K
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
23.8K
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
39.2K
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
70.7K
4.5 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#
38.5K
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
24.0K
4.5 points
M
Minimax MCP Server
The MiniMax Model Context Protocol (MCP) is an official server that supports interaction with powerful text-to-speech, video/image generation APIs, and is suitable for various client tools such as Claude Desktop and Cursor.
Python
55.4K
4.8 points
AIBase
Zhiqi Future, Your AI Solution Think Tank
© 2026AIBase