NPM Types MCP Server

An MCP (Model Context Protocol) server for providing TypeScript type definitions as MCP Resources. This server allows AI assistants to fetch and use TypeScript type definitions from NPM packages.

Overview

This server implements the Model Context Protocol to provide TypeScript type definitions from NPM packages. It allows AI assistants to:

• Fetch type definitions for any NPM package
• Access the latest or specific versions of package types
• Use these types to provide better code assistance

Prerequisites

• Node.js (v23.6.0 or higher)
• yarn (v1.22.22 or higher)

Installation

1. Clone this repository:

   git clone https://github.com/JackVCurtis/npm-types-mcp-server.git
   cd npm-types-mcp-server
   

2. Install dependencies:

   yarn
   

Usage

Starting the Server

To start the server, run:

yarn start

The server will start and listen for MCP connections via stdio.

Configuring with Augment

To use this server with the Augment extension:

1. Open Augment settings
2. Add a new MCP server with the following configuration:
   • Name: NPM Types
   • Command: /absolute/path/to/node /absolute/path/to/npm-types-mcp-server/index.ts
   • Replace /absolute/path/to/node with the path to your Node.js executable
   • Replace /absolute/path/to/npm-types-mcp-server with the absolute path to this repository on your system

Using the Server

Once configured, you can use the server to fetch type definitions for NPM packages. The server provides a tool called npm-types that can be used to fetch type definitions.

Example usage in Augment:

Fetch the types for the @randsum/dice package version 1.0.0

API

Tools

npm-types

Fetches the types for an NPM package.

Parameters:

• name (string): The name of the NPM package
• version (string): The version of the NPM package

Returns:

• The TypeScript type definitions for the specified package and version

Project Structure

• index.ts: Main entry point for the server
• package.json: Project dependencies and metadata
• tsconfig.json: TypeScript configuration

License

MIT

Author

Jack