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

patent-literature-search-mcp

patsnap

A professional tool for searching Patsnap’s global patent and literature databases using natural language, semantic, or keyword queries. It supports precise filtering and retrieves bibliographic data in Markdown format.

Fitralo

Search Europe's road freight carriers from your AI assistant: find carriers by route, equipment and certificates among 15,700+ checked carriers in 32 countries, in 14 languages. Read-only, no account needed for searching

Theyond

theyond

If it's here, it's on their board. Search live verified jobs from employer career pages.

3GPP Scout

3gppscout

Hosted 3GPP MCP server: cited search across Rel-15 through Rel-20 TS/TR specs, recent TDocs, company proposals and meeting decisions. OAuth 2.1; no local index required.

roTEAMnet — Global Job Search & Employer Discovery

roTEAMnet

Search 500,000+ active jobs worldwide, discover employers and explore remote, part-time and flexible work. Read full postings and open original application links for free. OAuth with scoped permissions; optional confirme