Ts Introspect MCP Server

🚀 TypeScript Package Introspector (MCP Server)

This is a tool for introspecting 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.
• Obtain detailed type signatures for all exported symbols.
• Extract JSDoc comments as descriptions.
• Provide type information to LLMs via MCP.

🚀 Quick Start

This tool can run as an MCP server, providing TypeScript package introspection capabilities for LLM applications such as Claude for Desktop. You can start it using the following command:

npx ts-introspect-mcp-server

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

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

💻 Usage Examples

Basic Usage

The MCP server provides the following tools:

introspect-package

Introspects an npm package and returns its exported symbols.

Parameters:

• packageName: The name of the npm package to introspect (e.g., 'zod')

introspect-source

Introspects TypeScript source code and returns exported symbols.

Parameters:

• source: The TypeScript source code to analyze

📦 Installation

Development

# Run tests
npm test

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

📄 License

MIT