MCP Code Search Server

@fx-an

Basic information

About MCP Code Search Server

一个MCP Server，帮助LLM查找相关代码在文件中的位置，支持返回完整的函数定义。

MCP Code Search Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-code-search-server": {
      "command": "npx",
      "args": [
        "mcp-code-search-server"
      ]
    }
  }
}

MCP Code Search Server tools

在指定目录中搜索代码标识符并返回其完整定义。此工具帮助查找变量、函数、类等定义的具体实现代码，而不仅是引用位置。通过获取完整的代码定义及其上下文，有助于理解代码的内部逻辑、数据流和依赖关系，从而更好地分析和解释代码功能。

Overview

What is mcp-code-search-server?

mcp-code-search-server is an MCP (Model Context Protocol) server that helps large language models (LLMs) find the location of relevant code within files and supports returning complete function definitions. It uses ripgrep to search for identifiers (variables, functions, classes, etc.) in a codebase and returns their full definitions, not just references.

How to use mcp-code-search-server?

Install with npm install mcp-code-search-server or pnpm install mcp-code-search-server. Run as a CLI tool with npx mcp-code-search-server. It can be integrated as an MCP server in LLM tools by configuring a command that launches npx -y mcp-code-search-server over stdio.

Key features of mcp-code-search-server

Searches code identifiers using ripgrep
Supports JavaScript/TypeScript, Java, and Python parsing
Extracts complete variable, function, and class definitions
Automatically detects and handles multiple file encodings (UTF-8, GBK, Big5, etc.)
Smart default filtering excludes common non-code directories and file types

Use cases of mcp-code-search-server

An LLM needs to locate and understand a specific function implementation in a large codebase
A developer uses an LLM-based coding assistant to retrieve full class definitions during refactoring
An automated code review tool searches for all usages and definitions of a variable
A language model analyzes dependencies by retrieving complete definitions of imported symbols

Frequently asked questions

What does mcp-code-search-server do?

It helps LLMs find the exact location of code identifiers (e.g., function names, variables, classes) in files and returns the complete definition, not just the line where it appears.

What programming languages are supported?

JavaScript/TypeScript, Java, and Python are explicitly supported for code parsing.

How do I install mcp-code-search-server?

Use `npm install mcp-code-search-server` or `pnpm install mcp-code-search-server`. Then run it with `npx mcp-code-search-server`.

What transport protocol does mcp-code-search-server use?

It communicates with the LLM via the stdio interface following the Model Context Protocol.

Does mcp-code-search-server filter out non-code files?

Yes. It provides default configuration to exclude common non-code directories and file types, with smart filtering.

Comments

More Search MCP servers

InstaVision

Find Instagram creators and leads by niche, city, follower range or lookalike accounts.

3gpp-mcp

higebu

An MCP (Model Context Protocol) server that makes 3GPP specifications accessible to LLMs.

Google Search MCP Server

HasData

Hosted Google Search / SERP MCP server from HasData, no Google Cloud project. Organic results, AI Overview, People Also Ask, AI Mode, news and shopping for Claude, Cursor and any MCP client.

Thordata MCP Server

Thordata

Thordata MCP Server gives AI agents real-time access to Google, Bing, DuckDuckGo, and Yandex search through one MCP connection. It supports structured results, geo-targeting, language and device parameters, SEO monitorin

CardsNearby

MCP server for CardsNearby — find local US card shops and card shows (sports, Pokémon, Magic, TCG) by location.