TypeScript MCP is an MCP server that connects Language Server Protocol instances to AI clients, providing advanced code manipulation and semantic analysis capabilities. Built on the lsmcp engine, the server bridges development environments with AI assistants such as Claude, allowing them to inspect project structures, navigate type definitions, and verify compiler diagnostics. Software developers and engineers use this tool to grant language-aware code intelligence directly to language models working in complex codebases. In addition to TypeScript via presets like tsgo, the server supports other language server runtimes including Rust, Go, OCaml, and Deno. It provides high-level tools for workspace exploration, cross-file reference tracking, precise symbol definitions, hover documentation, and automated code actions. TypeScript MCP also includes external library indexing, which scans node_modules declaration files to resolve imported definitions, alongside a persistent project memory system for storing architecture guidelines and project conventions. By operating through structured language server commands rather than raw string searching, it enables accurate, syntax-aware refactoring operations, parameter completions, and safe symbol renaming across entire multi-file software projects without breaking surrounding code.
Category: Developer Tools & Code Intelligence
Tags: code analysis, javascript, refactoring, typescript
Follow these steps to set up and register TypeScript MCP with Claude: 1. Ensure your environment has Node.js 22.0.0 or higher installed, as required for built-in SQLite support. 2. Install the necessary packages in your project: bash npm add -D @mizchi/lsmcp @typescript/native-preview 3. Initialize the server configuration using the TypeScript preset: bash npx @mizchi/lsmcp init -p tsgo 4. Add the server to Claude using the CLI: bash claude mcp add lsmcp npx -- -y @mizchi/lsmcp -p tsgo 5. Alternatively, specify a custom language server binary command: bash claude mcp add lsmcp npx -- -y @mizchi/lsmcp --bin="<lsp-command>" 6. Adjust indexing and concurrency options in .lsmcp/config.json as needed.
Part of MCP Servers
Install Node.js 22.0.0 or higher on your machine. Next, install the package and native preview with npm add -D @mizchi/lsmcp @typescript/native-preview, then initialize the configuration using npx @mizchi/lsmcp init -p tsgo. Finally, register the server in Claude by executing claude mcp add lsmcp npx -- -y @mizchi/lsmcp -p tsgo in your terminal.
TypeScript MCP exposes Language Server Protocol features to LLMs. It enables semantic code analysis, workspace-wide symbol searching, jumping to definitions, finding all usages of a symbol, diagnostic error checking, and code completions. It also supports automated symbol renaming, external node_modules library indexing, and a persistent memory system for tracking project conventions.
While specialized for TypeScript through the tsgo and typescript presets, the server also includes presets for Rust with rust-analyzer, Go with gopls, Deno, MoonBit, F# via fsautocomplete, OCaml, and Haskell Language Server. Custom language server binaries can also be connected using the manual bin command argument.
Yes, TypeScript MCP is open-source software distributed under the MIT license. You can inspect its source code, review community contributions, report issues, and view example configurations directly on GitHub at https://github.com/mizchi/typescript-mcp.
TypeScript MCP requires Node.js version 22.0.0 or higher to run. This specific runtime requirement is necessary because the underlying server relies on Node's built-in SQLite support for maintaining symbol caches, index metadata, and persistent project storage.