TypeScript Definitions MCP Server

Instructions

Implementation Reference

• src/type-indexer.ts:403-418 (handler)

  Core handler logic: iterates over program source files filtered by package, extracts type definitions using extractTypeDefinitions.

  async getPackageTypes(packageName: string): Promise<TypeDefinition[]> {
    if (!this.program) {
      throw new Error("TypeIndexer not initialized. Call initialize() first.");
    }
  
    const results: TypeDefinition[] = [];
    
    for (const sourceFile of this.program.getSourceFiles()) {
      if (this.isFromPackage(sourceFile.fileName, packageName)) {
        const definitions = this.extractTypeDefinitions(sourceFile);
        results.push(...definitions);
      }
    }
    
    return results;
  }

• src/mcp-server.ts:322-337 (handler)

  MCP server tool handler: validates args, calls typeIndexer.getPackageTypes, formats JSON response.

  private async handleGetPackageTypes(packageName: string) {
    const results = await this.typeIndexer.getPackageTypes(packageName);
    
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify({
            packageName,
            results,
            count: results.length
          }, null, 2)
        }
      ]
    };
  }

• src/mcp-server.ts:227-230 (registration)

  Tool registration in CallToolRequestHandler switch statement.

  case "get_package_types": {
    const packageArgs = this.validateArgs<ToolArguments["get_package_types"]>(args);
    return await this.handleGetPackageTypes(packageArgs.packageName);
  }

• src/mcp-server.ts:127-139 (schema)

  Input schema and metadata registered in ListToolsRequestHandler.

    name: "get_package_types",
    description: "Get all type definitions from a specific package",
    inputSchema: {
      type: "object",
      properties: {
        packageName: {
          type: "string",
          description: "Name of the package to get types from"
        }
      },
      required: ["packageName"]
    }
  },

• src/mcp-server.ts:19-19 (schema)

  TypeScript interface definition for tool arguments.

  get_package_types: { packageName: string };