TS Definition

Locates original TypeScript symbol definitions in your codebase for editor-assisted navigation.

typescript

1

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "runninghare-typescript-definition-finder-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ts-def-mcp@latest"
      ]
    }
  }
}

You run a TypeScript Definition Finder MCP Server to help AI code editors locate the original definitions of TypeScript symbols within your project. It exposes a local, stdio-based interface that integrates with editors to quickly jump to where a symbol is defined, including imported symbols from external packages and the code around the definition.

How to use

You connect an MCP client to this server to locate symbol definitions in your codebase. When you want to find where a TypeScript symbol is defined, provide the path to the current file, the symbol name, and the full line containing that symbol. The server will resolve the exact location and return the relevant code snippet surrounding the definition.

In practice, you will use the dedicated tool exposed by the server named find_typescript_definition. You trigger it from your MCP-enabled editor with the symbol you want to locate, along with the file path and the full line where the symbol appears. The server searches your project, including imported symbols, and returns the location and a snippet of the defining code so you can inspect it quickly.

How to install

Prerequisites you need before running the server:

Node.js installed on your machine.
A TypeScript project with the typescript dependency installed.

Install and run the MCP server locally using the following steps.

Install the MCP server via Smithery (for Claude Desktop integration):

npx -y @smithery/cli install @runninghare/typescript-definition-finder-mcp --client claude

Run the MCP server locally

In your TypeScript project directory, start the MCP server with the following command.

npx -y ts-def-mcp@latest

Notes on usage with editors

This MCP server uses a local filesystem to locate definitions, so it cannot be run behind Docker or over WebSocket when you rely on remote access. Run it directly on your machine to ensure full access to your project files.

You can integrate this server with editors that support MCP, such as Claude Desktop, Cursor, Windsurf, or Roo Cline Editor, by pointing them at the local stdio interface started with the command above.

Available tools

find_typescript_definition

Locates the original definition of TypeScript symbols in your codebase, returning the file location and a code snippet with the defining symbol.