Skip to main content
Glama
Sign In
code-intel-mcp

code-intel-mcp

by dothinh115
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

code-intel-mcp

MCP server for efficient codebase exploration by coding agents. List exports, get file outlines, read targeted regions, and find references — without loading whole files into context.

Tools

Tool

Input

Output

When to use

list_exports

path (file/folder), filter?, depth?

Name + signature + line + totalLines

Discover what a file/folder contains

file_outline

path (file), exportedOnly?

All symbols with line ranges

Understand structure before reading

read_region

path, start, end (max 200 lines)

Numbered source lines

Read only the code you need

find_references

symbol, path (dir), filePattern?, maxResults?

File:line + context

Trace call chains and usage

Related MCP server: ast-outline-mcp

Recommended agent workflow

1. list_exports(path, filter) → discover what exists and where
2. file_outline(file) → understand structure and line ranges
3. read_region(file, start, end) → read only the relevant ±30 lines
4. find_references(symbol, dir) → trace who calls it before modifying

Setup

Any MCP-compatible client (via npx)

No local install needed. Point your MCP client at:

command: npx
args: ["-y", "@dothinh/code-intel-mcp"]

Codex (desktop app / CLI)

Add to ~/.codex/config.toml:

[mcp_servers.code-intel]
command = "npx"
args = ["-y", "@dothinh/code-intel-mcp"]

Cursor

Add to .cursor/mcp.json (project-level) or global MCP settings:

{
  "mcpServers": {
    "code-intel": {
      "command": "npx",
      "args": ["-y", "@dothinh/code-intel-mcp"]
    }
  }
}

Claude Code

claude mcp add code-intel -- npx -y @dothinh/code-intel-mcp

Windsurf / Cline / Continue / other MCP clients

Use the same npx command and args in your client's MCP server configuration. The server communicates over stdio using newline-delimited JSON-RPC.

Requirements

  • Node.js >= 20

  • rg (ripgrep) on PATH — used by find_references

Supported languages

TypeScript, JavaScript, Vue SFC, and Svelte for export detection and file outlines. find_references works with any text file that ripgrep can read (Python, Go, Rust, etc.).

Local development

git clone git@github.com:dothinh115/code-intel-mcp.git
cd code-intel-mcp
yarn install
yarn build
node dist/index.js   # starts MCP server on stdio

License

MIT

Available Tools

4 tools
file_outlineA

Get a structural outline of a single file: every function, class, interface, type, enum, and top-level const with line ranges. Shows both exported and non-exported symbols. Use to understand file structure before reading a specific region.

Inputs: path (required), exportedOnly.

find_referencesA

Find all references to a symbol (function, class, variable, type) across a directory using ripgrep. Returns file, line, and matching text. Use to trace call chains and understand usage before modifying.

Inputs: path (required), symbol (required), maxResults, filePattern.

list_exportsA

List all exported symbols (functions, classes, types, consts) from a file or folder. Returns name, signature, file, line number, and total file lines. Use this instead of reading a whole file to discover what it contains.

Inputs: path (required), depth, filter.

read_regionA

Read a specific line range from a file (max 200 lines per call). Returns numbered source lines. Use after list_exports or file_outline to read only the code you need instead of the whole file.

Inputs: end (required), path (required), start (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    TDQS

    A4.2/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool serves a clear, non-overlapping purpose: listing exports, file structure outlines, reading specific regions, and finding references. No ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case, making them predictable and easy to understand.

    Tool Count5/5

    Four tools is an ideal size for a code intelligence server, covering essential operations without being too sparse or overwhelming.

    Completeness5/5

    The set provides a complete workflow for code exploration: discover exports, understand structure, read code, and find usages. No obvious gaps for its intended purpose.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    Related MCP Servers

    • ast-outline-mcp

      Xayan
      A
      license
      A
      quality
      C
      maintenance
      Enables AI coding agents to efficiently explore codebases by providing structural outlines, module digests, symbol bodies, and AST-aware grep via MCP.
      4
      10 npm
      1
      MIT

    • codebase-rag

      Ar-maan05
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables LLM agents to efficiently understand and navigate a codebase by providing semantic search over symbols and a reference graph, replacing expensive grep/glob calls with structured tools like definition lookup, caller/callee queries, and change-impact analysis.
      4
      MIT