TypeScript Package Introspector (MCP Server) logo

TypeScript Package Introspector (MCP Server)

by t3ta

This tool introspects TypeScript packages and source code to extract exported symbols and their type information. It runs as a Model Context Protocol (MCP) server.

View on GitHub

Last updated: N/A

TypeScript Package Introspector (MCP Server)

This tool introspects TypeScript packages and source code to extract exported symbols (functions, classes, types, constants) and their type information. It runs as a Model Context Protocol (MCP) server.

Features

  • Extract exported symbols from npm packages using their type definitions
  • Analyze TypeScript source code directly
  • Get detailed type signatures for all exported symbols
  • Extract JSDoc comments as descriptions
  • Provide type information to LLMs through MCP

Usage

This tool can be run as an MCP server to provide TypeScript package introspection capabilities to LLM applications like Claude for Desktop. You can start it using npx:

npx ts-introspect-mcp-server

To integrate it with your project, create a .roo/mcp.json configuration file:

{
  "mcpServers": {
    "ts-introspect": {
      "command": "npx",
      "args": ["-y", "ts-introspect-mcp-server"]
    }
  }
}

MCP Tools

The MCP server provides the following tools:

introspect-package

Introspects an npm package and returns its exported symbols.

Parameters:

  • packageName: Name of the npm package to introspect (e.g., 'zod')
introspect-source

Introspects TypeScript source code and returns the exported symbols.

Parameters:

  • source: TypeScript source code to analyze

Development

# Run tests
npm test

# Start the MCP server in development mode
npm run start:mcp

License

MIT