TypeScript Definition Finder MCP Server

Name: TypeScript Definition Finder MCP Server
Author: runninghare

@runninghare

About TypeScript Definition Finder MCP Server

A Model Context Protocol (MCP) server that helps AI code editors find TypeScript symbol definitions in your codebase. This tool is particularly useful when you need to locate the original definition of imported symbols, classes, interfaces, or functions in a TypeScript project.

Basic information

Config

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

{
  "mcpServers": {
    "typescript-definition-finder-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@runninghare/typescript-definition-finder-mcp",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is TypeScript Definition Finder MCP Server?

A Model Context Protocol (MCP) server that helps AI code editors locate the original definition of TypeScript symbols (variables, classes, interfaces, functions) in your codebase. It works with imported symbols from external packages and returns both the definition location and a code snippet. Designed for developers using AI coding tools like Claude Desktop, Cursor, Windsurf, or Roo Cline Editor.

How to use TypeScript Definition Finder MCP Server?

Install via Smithery (npx -y @smithery/cli install @runninghare/typescript-definition-finder-mcp --client claude) or run npx -y ts-def-mcp@latest in your project directory. The server exposes a single tool find_typescript_definition that requires three parameters: file_path (absolute path to the current file), symbol (the symbol to find), and line_content (the exact line containing the symbol). The trigger command /ts-def can be used in Cursor to force the AI editor to find a referenced symbol definition.

Key features of TypeScript Definition Finder MCP Server

Finds original definitions of TypeScript symbols
Works with imported symbols from external packages
Returns both the definition location and code snippet
Supports stdio interface for seamless AI code editor integration
Trigger command /ts-def available in Cursor

Use cases of TypeScript Definition Finder MCP Server

Locating the original definition of an imported symbol from an external package
Finding where a local class, interface, or function is defined
Helping AI code editors understand symbol origins during code generation or refactoring

FAQ from TypeScript Definition Finder MCP Server

What prerequisites are needed?

A TypeScript project with the typescript dependency installed, and Node.js for running the server.

How is the server integrated with AI code editors?

It communicates via the stdio interface (Model Context Protocol stdio server). It can be used with Claude Desktop, Cursor, Windsurf, and Roo Cline Editor.

Does the server support Docker or WebSocket installation?

No. Due to local filesystem access requirements, Docker + WebSocket solutions will not work. The Smithery installation guide for Docker should be ignored.