TypeScript Definition Finder MCP Server
@runninghare
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.
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-defavailable 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.
