Ts Introspect MCP Server

🚀 TypeScript 包 Introspector（MCP 服务器）

TypeScript 包 Introspector 是一款强大的工具，它能够对 TypeScript 包和源代码进行内省，精准提取导出符号（如函数、类、类型、常量）及其类型信息。同时，它还可作为 Model Context Protocol (MCP) 服务器运行，为后续的开发和应用提供有力支持。

✨ 主要特性

• 包符号提取：可从 npm 包中依据其类型定义提取导出符号。
• 源码直接分析：能够直接对 TypeScript 源代码进行分析。
• 类型签名获取：获取所有导出符号的详细类型签名。
• 注释提取：提取 JSDoc 注释作为描述。
• 信息提供：通过 MCP 向 LLM 提供类型信息。

🚀 快速开始

此工具可以作为 MCP 服务器运行，为 Claude for Desktop 等 LLM 应用提供 TypeScript 包内省能力。你可以使用以下命令启动它：

npx ts-introspect-mcp-server

要将其集成到项目中，请创建一个 .roo/mcp.json 配置文件：

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

💻 使用示例

基础用法

启动 MCP 服务器：

npx ts-introspect-mcp-server

集成到项目中创建配置文件：

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

高级用法

MCP 工具

MCP 服务器提供了以下工具：

introspect-package

Introspects 一个 npm 包并返回其导出符号。

参数：

• packageName: 要 introspect 的 npm 包名称（例如，'zod'）

introspect-source

Introspects TypeScript 源代码并返回导出符号。

参数：

• source: 要分析的 TypeScript 源代码

📦 安装指南

此工具可通过以下命令启动：

npx ts-introspect-mcp-server

🔧 技术细节

在开发过程中，你可以使用以下命令进行测试和启动 MCP 服务器：

# 运行测试
npm test

# 在开发模式下启动 MCP 服务器
npm run start:mcp

📄 许可证

本项目采用 MIT 许可证。