Ts Def MCP

🚀 TypeScript 定義検索 MCP サーバー

このツールは、Model Context Protocol (MCP) サーバーで、AI コードエディタがあなたのコードベース内で TypeScript シンボルの定義を見つけるのを支援します。特に、外部パッケージからインポートされたシンボル、クラス、インターフェース、または関数の元の定義を見つける必要がある場合に便利です。

✨ 主な機能

• TypeScript シンボルの元の定義を検索
• 外部パッケージからインポートされたシンボルをサポート
• 定義の位置とコードスニペットを返す
• stdio インターフェースをサポートし、AI コードエディタとのシームレスな統合を可能にする

📦 インストール

Smithery を使用したインストール

Smithery を通じて Claude Desktop 用の TypeScript 定義検索ツールを自動インストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @runninghare/ts-def-mcp --client claude

手動インストール

1. 依存関係をインストールします。

bun install

2. プロジェクトをビルドします。

bun run build

💻 使用例

基本的な使用法

stdio サーバーを起動するには、以下のコマンドを実行します。

node dist/run.js

ツールの説明

このサーバーは find_typescript_definition ツールを提供しており、以下の機能を持っています。

• ツール名：find_typescript_definition
• トリガーコマンド：/ts-def（Cursor で使用する場合、AI エディタに参照シンボルの定義を検索させることができます）
• 目的：TypeScript コードベース内のシンボルの元の定義を見つける

入力パラメータ

このツールには 3 つのパラメータが必要です。

1. file_path (文字列)：

   • 現在の TypeScript ファイルの絶対パス
   • 例：/path/to/your/project/src/index.ts

2. line_content (文字列)：

   • 検索対象のシンボルが含まれる行全体の内容
   • ファイル内の正しい行を特定するために使用されます
   • ファイル内の行と完全に一致する必要があります

3. column_number (数値)：

   • シンボルの開始位置の 1 から始まる列番号
   • シンボルの最初の文字の正確な列位置である必要があります

具体的な使用例

インポートされたシンボルの定義を検索する

以下のインポート文があるとします。

import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

StdioServerTransport の定義を検索するには、以下の JSON を使用します。

{
  "file_path": "~/my-mcp-project/src/index.ts",
  "line_content": "import { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";",
  "column_number": 10
}

このツールの出力は次のようになります。

[
  {
    "file": "~/my-mcp-project/node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.d.ts",
    "type": "Definition",
    "location": "Line 9, Column 22",
    "codeSnippet": "   8    */\n   9 > export declare class StdioServerTransport implements Transport {\n  10 +     private _transport: Transport;\n  11 +     private _buffer: Buffer;\n  12 +     private _closed: boolean;\n  13 +     constructor(transport: Transport, options?: OpenOptions);\n  14 +     connect(): Promise<void>;\n  15 +     disconnect(): void;\n  16 +     send(data: Buffer | Array<Buffer>): Promise<void>;\n  17 +     close(): void;\n  18 + }"
  }
]

プライベートトランスポートの定義を検索する

以下の行があるとします。

private _transport: Transport;

Transport の定義を検索するには、以下の JSON を使用します。

{
  "file_path": "~/my-mcp-project/src/transports/index.ts",
  "line_content": "  private _transport: Transport;",
  "column_number": 9
}

応答形式

このツールは JSON 形式の応答を返し、以下の情報を含みます。

• 定義があるファイルのパス
• 定義の行番号
• 定義の実際のコードスニペット

📚 ドキュメント

開発環境での実行

このプロジェクトは bun v1.2.2 で bun init を使用して作成されました。Bun は高速な JavaScript ランタイムです。開発中は、Bun を直接使用してサーバーを実行できます。

bun run index.ts

📄 ライセンス

[ここにライセンス情報を追加してください]

貢献

[ここに貢献ガイドを追加してください]