TS Hover MCP

Maintenance moved to zachsents/zachs-tools. This repository is kept for history; open new issues and changes in the monorepo.

Give AI agents TypeScript type inference — no editor required.

A standalone MCP server that provides TypeScript type information using tsgo (the native Go-based TypeScript compiler). Works with any MCP client — Cursor, Claude Desktop, VS Code, Windsurf, or any other agent.

No running editor needed. It spawns and manages tsgo LSP instances directly, keeping them warm for fast subsequent queries.

Prerequisites

Install tsgo globally:

npm install -g @typescript/native-preview
# or
bun add -g @typescript/native-preview
# or
pnpm add -g @typescript/native-preview
# or
yarn global add @typescript/native-preview

Related MCP server: MCP-Typescribe

Install

Cursor

Or manually add to .cursor/mcp.json:

{
  "mcpServers": {
    "ts-hover": {
      "command": "npx",
      "args": ["-y", "@zachsents/ts-mcp"]
    }
  }
}

VS Code

Add to your User Settings (JSON):

{
  "mcp": {
    "servers": {
      "ts-hover": {
        "command": "npx",
        "args": ["-y", "@zachsents/ts-mcp"]
      }
    }
  }
}

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "ts-hover": {
      "command": "npx",
      "args": ["-y", "@zachsents/ts-mcp"]
    }
  }
}

Claude Code

claude mcp add-json ts-hover '{"command":"npx","args":["-y","@zachsents/ts-mcp"]}'

Windsurf

Add to your Windsurf MCP config:

{
  "mcpServers": {
    "ts-hover": {
      "command": "npx",
      "args": ["-y", "@zachsents/ts-mcp"]
    }
  }
}

How it works

1. Agent calls a tool (e.g. hover with a file path and position)

2. The MCP server finds the nearest tsconfig.json to determine the project root

3. It spawns (or reuses) a tsgo LSP instance for that project

4. Returns the type information

5. The tsgo instance stays warm for 5 minutes, making follow-up queries near-instant

Multiple project roots are handled automatically — each gets its own tsgo instance.

Tools

hover

Get TypeScript type information at a position, plus where it's defined. Returns the same info you'd see hovering in an IDE — resolved types, inferred types, JSDoc — and the definition location.

diagnostics

Get TypeScript errors and warnings for a file, along with available quick fixes and their exact text edits.

references

Find all references to a symbol across the project.

outline

Get a structured outline of all symbols in a file — functions, classes, interfaces, types, variables — with line numbers and nesting.

rename

Rename a symbol across the project. Applies the edits directly to all affected files.

inlay_hints

Get inferred type annotations for a line range — variable types, parameter types, return types that TypeScript infers but aren't written in code.

Note: Requires tsgo inlay hint support, which is still in development. The tool will start returning results as tsgo fills in this capability.

Configuration

License

MIT — Zach Sents