TypeScript Type Fetcher

A Model Context Protocol (MCP) tool for providing TypeScript type definitions from npm packages.

Description

TypeScript Type Fetcher is a Model Context Protocol (MCP) service that provides TypeScript type definitions from npm packages. It runs as an MCP server that communicates through standard input/output (stdio), making it compatible with any MCP-enabled development environment.

MCP Service Details

This tool implements an MCP server that:

- Communicates via stdio using the MCP protocol
- Provides a tool endpoint for fetching TypeScript types
- Offers a resource endpoint for package information
- Handles errors with meaningful messages and package suggestions

The server exposes:
- Tool: typescript-types - For fetching type definitions
- Resource: typescript-package://{name}@{version} - For package information

Features

- Fetch TypeScript type definitions from any npm package
- Support for specific package versions
- Fuzzy matching for package names with suggestions
- Direct integration with MCP-compatible environments

Installation

You can install globally:
``bash
npm install -g typescript-type-fetcher
`

Or install as a project dependency:
`bash
npm install typescript-type-fetcher
`

Usage

$3

You can run the tool directly using npx:
`bash
npx typescript-type-fetcher
`

This will start the MCP server that communicates through stdio. Note that this tool is designed to be used as an MCP service, so it expects MCP protocol messages through stdin and responds through stdout.

$3

The tool can be used as an MCP server that provides two main functionalities:

$3

Fetch type definitions for a specific package:

`typescript
{
"tool": "typescript-types",
"args": {
"packageName": "lodash",
"version": "4.17.21", // optional
"fuzzyMatch": true // optional
}
}
`

$3

Access package information using the resource URI format:

`
typescript-package://{name}@{version}
`

API Response Format

$3

On success:
`typescript
{
"content": [
{
"type": "text",
"text": "Type definitions for package@version"
},
{
"type": "text",
"text": "// Type definition content",
"language": "typescript"
}
// ... additional type files
]
}
`

On error:
`typescript
{
"error": "Error message"
}
`

$3

`typescript
{
"name": "package-name",
"version": "1.0.0",
"fileCount": 5,
"success": true,
"error": null
}
`

Requirements

- Node.js >= 14.16

Development

`bash


Install dependencies

npm install

Build the project

npm run build

Start the server

npm start

Watch mode during development

npm run dev

Clean build artifacts

npm run clean
``

License

[License type to be specified]