TypeScript Definition Finder MCP Server

@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.

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

Fetch the live tool list by running this server in a temporary sandbox using the button above.

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.

What does the tool return?

A JSON response containing the file path where the definition was found, the line number, and the actual code snippet of the definition.

What transports are supported?

Only stdio transport is supported. The server does not support HTTP or WebSocket transports.

Frequently asked questions

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.

What does the tool return?

A JSON response containing the file path where the definition was found, the line number, and the actual code snippet of the definition.

What transports are supported?

Only stdio transport is supported. The server does not support HTTP or WebSocket transports.

Comments

Basic information

More Other MCP servers

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

Nginx UI

0xJacky

Yet another WebUI for Nginx

11.3K