TypeScript 정의 찾기 MCP 서버

AI 코드 편집기가 코드베이스에서 TypeScript 심볼 정의를 찾을 수 있도록 돕는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 도구는 TypeScript 프로젝트에서 가져온 심볼, 클래스, 인터페이스 또는 함수의 원래 정의를 찾아야 할 때 특히 유용합니다.

특징

TypeScript 기호의 원래 정의를 찾습니다.
외부 패키지에서 가져온 심볼로 작동합니다.
정의 위치와 코드 조각을 모두 반환합니다.
AI 코드 편집기와의 원활한 통합을 위해 stdio 인터페이스를 지원합니다.

필수 조건

Bun v1.2.2 이상
컴파일된 서버를 실행하기 위한 Node.js

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 TypeScript Definition Finder를 자동으로 설치하려면 다음을 수행합니다.

지엑스피1

수동 설치

종속성 설치:

bun install

프로젝트를 빌드하세요:

bun run build

용법

stdio 서버를 시작합니다.

node dist/run.js

도구 설명

서버는 다음과 같은 기능을 갖춘 find_typescript_definition 도구를 제공합니다.

도구 이름 : find_typescript_definition
트리거 명령 : /ts-def (AI 편집기가 참조된 심볼 정의를 찾도록 하려는 경우 Cursor 에서 유용함)
목적 : 코드베이스에서 TypeScript 심볼의 원래 정의를 찾습니다.

입력 매개변수

이 도구에는 세 가지 매개변수가 필요합니다.

file_path (문자열):
- 현재 TypeScript 파일의 절대 경로
- 예: /path/to/your/project/src/index.ts
line_content (문자열):
- 정의를 찾고자 하는 기호가 포함된 전체 줄
- 파일에서 올바른 줄을 찾는 데 사용됩니다.
- 파일에서 나타나는 것과 정확히 일치하는 줄이어야 합니다.
column_number (숫자):
- 기호가 시작되는 1부터 시작하는 열 번호
- 기호의 첫 번째 문자의 정확한 열 위치여야 합니다.

예시

가져온 심볼 정의 찾기

다음과 같은 수입 진술이 주어졌습니다.

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

열 10에서 시작하는 StdioServerTransport 의 정의를 찾으려면 다음을 사용합니다.

{
  "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 _stdin;\n  11 +     private _stdout;\n  12 +     private _readBuffer;\n  13 +     private _started;\n  14 +     constructor(_stdin?: Readable, _stdout?: Writable);\n  15 +     onclose?: () => void;\n  16 +     onerror?: (error: Error) => void;\n  17 +     onmessage?: (message: JSONRPCMessage) => void;\n  18 +     _ondata: (chunk: Buffer) => void;\n  19 +     _onerror: (error: Error) => void;\n  20 +     /**\n  21 +      * Starts listening for messages on stdin.\n  22 +      */\n  23 +     start(): Promise<void>;\n  24 +     private processReadBuffer;\n  25 +     close(): Promise<void>;\n  26 +     send(message: JSONRPCMessage): Promise<void>;\n  27   }\n"
  }
]

로컬 심볼 정의 찾기

로컬 클래스 사용의 경우:

class MyService {
  private transport: StdioServerTransport;
}

20열에서 시작하는 StdioServerTransport 의 정의를 찾으려면 다음을 사용하세요.

{
  "file_path": "/path/to/project/src/service.ts",
  "line_content": "  private transport: StdioServerTransport;",
  "column_number": 20
}

응답 형식

이 도구는 다음을 포함하는 JSON 응답을 반환합니다.

정의가 발견된 파일 경로
정의의 줄 번호
정의의 실제 코드 조각

클로드 데스크톱 예제

개발

이 프로젝트는 bun v1.2.2에서 bun init 사용하여 생성되었습니다. Bun은 빠른 올인원 JavaScript 런타임입니다.

개발 모드에서 실행

개발을 위해 Bun을 사용하여 서버를 직접 실행할 수 있습니다.

bun run index.ts

특허

[여기에 라이센스 정보를 추가하세요]

기여하다

[여기에 기여 지침을 추가하세요]

Integrations