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 許可證。