NPM Types MCP Server

What is NPM Types MCP Server?

NPM Types MCP Server is a Model Context Protocol (MCP) server that provides TypeScript type definitions as MCP Resources. It allows AI assistants to fetch and use TypeScript type definitions from NPM packages, including specific versions.

How to use NPM Types MCP Server?

Install Node.js v23.6.0+ and yarn v1.22.22+, clone the repository, install dependencies with yarn, and start the server with yarn start. Configure it in Augment by adding an MCP server with the command /absolute/path/to/node /absolute/path/to/npm-types-mcp-server/index.ts. Once configured, the server exposes a tool called npm-types that accepts name (package name) and version parameters.

Key features of NPM Types MCP Server

• Fetches TypeScript type definitions from any NPM package
• Supports requesting the latest or specific version of package types
• Provides types as MCP Resources for AI assistant consumption
• Connects via stdio using the Model Context Protocol
• Integrates with Augment extension for code assistance

Use cases of NPM Types MCP Server

• AI assistants fetching type definitions for NPM packages to improve code suggestions
• Developers retrieving specific version types for package documentation or analysis
• Automated tooling that needs real-time access to TypeScript type information
• Enhancing IDE-like assistance in conversational coding environments

FAQ from NPM Types MCP Server

What is the purpose of NPM Types MCP Server?

It serves TypeScript type definitions from NPM packages as MCP Resources, enabling AI assistants to use those types for better code assistance.

What are the runtime requirements?

Node.js version 23.6.0 or higher and yarn version 1.22.22 or higher are required.

How does the server connect to clients?

The server listens for MCP connections via stdio. It can be configured with the Augment extension by specifying the node and index.ts paths.

What tool does it provide and what parameters does it need?

It provides a tool called npm-types that requires two parameters: name (the NPM package name) and version (the package version). It returns the TypeScript type definitions for that package.

How are type definitions obtained?

The server fetches type definitions from NPM packages, either the latest version or a specified version, by accessing the package’s type files.