Package Exports

@treedy/typescript-lsp-mcp
@treedy/typescript-lsp-mcp/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@treedy/typescript-lsp-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

TypeScript LSP MCP

MCP server providing TypeScript/JavaScript code intelligence using the official TypeScript Language Service.

Features

hover - Get type information and documentation at a position
definition - Jump to symbol definition
references - Find all references to a symbol
completions - Get code completion suggestions
signature_help - Get function signature information
symbols - Extract symbols (classes, functions, methods, variables)
diagnostics - Get type errors and warnings
rename - Preview symbol renaming
search - Search for patterns in files (ripgrep-style)
update_document - Update file content for incremental analysis
status - Check TypeScript environment status

Installation

# Using npx
npx @treedy/typescript-lsp-mcp

# Or install globally
npm install -g @treedy/typescript-lsp-mcp

MCP Configuration

Add to your .mcp.json or Claude Code settings:

{
  "mcpServers": {
    "typescript-lsp": {
      "command": "npx",
      "args": ["@treedy/typescript-lsp-mcp"]
    }
  }
}

Or run directly with Bun:

{
  "mcpServers": {
    "typescript-lsp": {
      "command": "bun",
      "args": ["run", "/path/to/typescript-lsp-mcp/dist/index.js"]
    }
  }
}

Development

# Install dependencies
bun install

# Build
bun run build

# Run in development mode (with hot reload)
bun run dev

# Test with MCP Inspector
bun run inspector

Architecture

Uses the official TypeScript Language Service API directly:

┌─────────────────┐     stdio      ┌─────────────────────┐
│  Claude / AI    │ ◄────────────► │  typescript-lsp-mcp │
│                 │      MCP       │                     │
└─────────────────┘                └─────────┬───────────┘
                                             │
                                             ▼
                                   ┌───────────────────┐
                                   │    TypeScript     │
                                   │  Language Service │
                                   └───────────────────┘

License

MIT